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Preface 


Purpose 


This publication applies to the Serviceability Enhancements Support Supplement to VM/XA System 
Product Release 2 (APAR VM37518). It explains how to service your VM/XA System Product system. 


Use it to supplement VM/XA SP Installation and Service, SC23-0364, and the VM/XA SP System 
Messages and Codes Reference, SC23-0376. 


Audience 


This publication is intended for those people responsible for installing and applying service to the VM/XA 
System Product Release 2. 


How to Use This Publication 


Use this book in conjunction with the VM /XA SP Installation and Service, SC23-0364. The information in 
this book replaces the Table of Contents, Chapters 6 through 20, and Appendixes A through I, and adds a 
new appendix, Appendix J. 


Technical changes and additions to the text and illustrations are indicated by a vertical bar (|) to the left of 
the change. 


There are no programming interfaces defined in this publication. 
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Part 2. Servicing the System 


Part 2 of this book contains the following chapters: 


¢ Chapter 6, “VM/XA™ Sytem Product Service—An Overview” on page 355, which provides an overview 
of the service tasks that you may need to perform. It also contains a description of the MAINT virtual 
machine (the user ID that you use to perform the service), and a list of the tools and EXECs you use to 
apply service. 


¢ Chapter 7, “How VM/XA System Product Uses Control Files and Update Files” on page 377, which 
describes what control files and update files are, and how VM/XA SP uses them 


¢ Chapter 8, “Files Used in Program Update Service and Corrective Service” on page 385, which describes 
the program update tape, the corrective service tape, and the files used in applying program update 
service or corrective service to VM/XA SP 


¢ Chapter 9, “Receiving Program Update Service or Corrective Service for CMS” on page 435, which 
provides a procedure for receiving program update service or corrective service for CMS 


( | ¢ Chapter 10, “Receiving Program Update Service or Corrective Service for CP” on page 443, which 
provides a procedure for receiving program update service or corrective service for CP 


¢ Chapter 11, “Applying Program Update Service or Corrective Service to CMS” on page 449, which 
provides a procedure for applying program update service or corrective service to CMS 


e Chapter 12, “Applying Program Update Service or Corrective Service to CP” on page 453, which 
provides a procedure for applying program update service or corrective service to CP 


e Chapter 13, “Rebuilding CMS after Applying Service” on page 457, which provides a step-by-step 
C procedure for rebuilding CMS after applying program update service, corrective service, or local service 


¢ Chapter 14, “Rebuilding CP after Applying Service” on page 515, which provides a step-by-step 
procedure for rebuilding CP after applying program update service, corrective service, or local service 


e Chapter 15, “Program Update Service or Corrective Service to the Dump Viewing Facility” on page 537, 
which outlines a procedure for receiving and applying program update service or corrective service to the 
dump viewing facility and for rebuilding the dump viewing facility 


¢ Chapter 16, “Program Update Service or Corrective Service to GCS” on page 547, which outlines a 
procedure for receiving and applying program update service or corrective service to the group control 
system and for rebuilding the group control system 


( , ¢ Chapter 17, “Program Update Service to Licensed Programs” on page 563, which outlines a procedure 
7 for receiving and applying program update service to products that have a product service EXEC rather 
than a product parameter file 


¢ Chapter 18, “Receiving and Applying Local Service” on page 565, which provides a step-by-step 
procedure for receiving and applying local service to VM/XA System Product 


¢ Chapter 19, “Emergency Local Service Using the Patch Facility” on page 577, which provides a 
step-by-step procedure for applying patches to the CP or CMS nucleus 


¢ Chapter 20, “Removing Service from VM/XA SP” on page 581, which describes how to remove service 
from VM/XA System Product. 


VM/XA SP is a trademark of the International Business Machines Corporation 
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This chapter contains: 
An introduction to service 
An overview of program update service 
An overview of local service 


A description of using the MAINT virtual machine for service 


A description of the tools and EXECs used in applying local service. 


introduction 


The VM/XA system as installed by the customer consists of several products, such as VM/XA System 
Product, PROFS, and FORTRAN. VM/XA System Product is a product which consists of the components 
CP, CMS, GCS, and dump viewing facility. Each component consists of numerous parts, such as macros, 
copy files, assembler modules, text decks, executable modules, and EXECs. Some parts are serviced by 
complete part replacement only. These parts are sometimes called object-maintained code. Other parts are 
serviced by combining an update with the base part. These parts are sometimes called source-maintained 
code. 


Parts serviced by replacement require the addition of a replacement part to the system. Parts serviced by 
update require the careful application of an update file to the existing control structure. 


Each problem that requires a fix from IBM 1s assigned an authorized problem analysis report (APAR) 
number. (The term “APAR” is ordinarily used to refer to both the fix and the report. In this book, 
“APAR” means the fix.) An APAR may contain service to more than one part. It may contain update 
service, replacement service, or both. 


A program temporary fix (PTF) is a package of APARs. For update service, the PTF contains only one 
APAR, because each update file is a change, or “delta”, to the base part. Each problem is fixed by the 
application of a separate delta. For replacement service, the PTF may contain more than one APAR, 
because replacement parts must include all previous APAR fixes in addition to the APAR fix for the problem 
being solved by the replacement. Figure 5 on page 356 shows three PTFs being applied to the system. PTF 
1 and PTF 3 each contain a single APAR consisting of an update to Part A. PTF 2 is more complex. It 
contains three APARS: APAR V, APAR W, and APAR X. All three APARs require adding a replacement 
part to Part C. APAR X also includes updates to Part A and Part B. (PTF 2 is cumulative. Two earlier 
PTFs are also available, one containing only APAR V and one containing APAR V and APAR W.) 
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Update service | | Replacement service 
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APAR R update 


PTF 1 
APAR X update APAR X update 
PTF 2 PTF 2 


APAR Z update 


PTF 3 


Figure 5. Update Service and Replacement Service 


Service is the process of applying fixes—PTFs to whenever they are available to the system after installation. 
Problems fall into these categories: 


° A PTF is available on the latest program update tape (PUT). 
¢ A PTF is available, but no PUT is available. 
e No PTF is available. 


These circumstances determine the format in which the service is supplied. This, in turn, decides the 
procedure for applying it. These procedures are: 


e Program update service: 


~— A PTF is available. 

— The PTF is supplied on a PUT tape. 

— The PTF is automatically applied. 

— Application may be preventive (massive application) or selective. 


¢ Remedial service, to be replaced by program update service when a PUT becomes available. 
— Corrective service: 


— A PTF is available, but no PUT is available. 
— The PTF is supplied on a corrective service tape. 
— The PTF is automatically applied. 


— Local service: 


— No PTF is available. 

— The service is originated by the customer, or is supplied by IBM on a tape other than a PUT 
tape or corrective service tape, in hard copy, or over the phone. 

— The service is manually applied. 

— The service may correct the problem or circumvent it (branch around or otherwise avoid the 
code in which the problem occurs). | 


Note: These classifications have nothing to do with the classification of service as update service or 
replacement service. Program update service, corrective service, and local service can all require either 
updates or replacement. 


Both massive and selective application of PTFs on the PUT use the same procedure, called program update 
service because its input comes from the program update tape. Massive application of PTFs on the PUT 1s 
intended to avoid problems. For this reason, program update service is sometimes called preventive service. 
Selective application of PTFs on the PUT is a response to a problem after it occurs. 
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When a problem occurs for which a PTF does not exist on the latest PUT, IBM will provide a corrective fix 
if the problem is known and the PTF is ready for the next PUT. Corrective service comes on a corrective 
service tape with the same format as the program update tape. It is applied in essentially the same way as 
program update service. 


If the problem is not known, IBM may be able to provide a temporary circumvention over the phone for a 
severe problem. (Circumventive service may also be provided on tape.) The circumvention usually does not 
fix the problem, but prevents failure by disabling the failing function. In this book, service that does not 
come from the PUT tape or a corrective service tape is called local service, even when you get it from IBM. 


Local service for replacement parts is like the procedure used for update parts, except that you do not need 
to assemble replacements for object code. Once updates are applied and assemblies are completed, update 
parts and replacement parts are the same. 


For parts on replacement service there are two circumventive procedures. One procedure, the patch facility, 
is for the CP nucleus and CMS nucleus. The other procedure uses ZAP for CP utilities and command 
modules not in the nucleus. 


Program Update Service Overview 


All IBM customers have a Customer Profile at IBM Software Distribution, or ISD (formerly known as PID). 
This profile lists all program products for which a customer has licenses. ISD sends out program update 
service tapes which are tailored to the Customer Profile—this is how you receive program update service for 
those program products for which you have licenses. 


It arrives in the form of a Program Update Tape (or PUT), which you apply automatically using a set of 
EXECs. The PUT, which may be one or more tape volumes, contains program update service files for one 
or more program products. 


| ( Program update service is sent out to VM/XA SP customers either on a regular basis or when you request it. 


The PUT is cumulative. All update files up to the current level are included. For parts serviced by updates 
(source-maintained code), the latest text deck, which includes all APARs up to the current level, is also 
shipped. For parts serviced by replacement (object-maintained code), a deck is shipped for each PTF and 
will be reshipped for several PUT cycles. | 


a The VMFREC EXEC is used to load program update service for each VM/XA System Product component 
( to the appropriate DELTA disk as specified in the product parameter file (PPF). The VMFAPPLY EXEC 1s 
used to apply it and to build the AUX control structure on the specified APPLY disk. The VMFBLD EXEC 
is used to build your nucleus after you receive and apply service. These EXECs are supplied on the VM/XA 
System Product product tape. 


For products other than VM/XA System Product, the service files include a CMS service EXEC for each 
program product on the PUT. The service EXEC is especially designed for that program product. 
VMFREC maps the PUT and calls the appropriate service EXEC for each product, other than VM/XA 
System Product, being serviced. 


The PUT also contains an EXEC called VMSERV, for compatibility. For products other than VM/XA 
System Product, you can use VMSERV as an alternative to VMFREC. Mount the tape on a tape drive, load 
the first tape file under CMS, and invoke the VMSERV EXEC. VMSERYV supervises the installation of 
program update service for the program products you have. 


Chapter 6. VM/XA System Product Service—An Overview 357 


The format of each volume of the PUT is as follows: 


° The first tape file contains the PUT DOCUMENT, the VMSERV EXEC, and the latest tested level of 
the service EXECs (with PTF-numbered file names). 


e The second tape file contains a Memo to Users for each program product service on the volume, and the 
latest tested level of the product parameter file for each product on the tape. 3 


¢ The remaining tape files contain service files for the program products on that volume. 


When you invoke the VMFREC EXEC with the INFO (MEMOS option, you can load the PUT document 
and all memos to users to disk and print them. You must read the instructions on the PUT document and 
the Memo to Users before you continue program update service installation. 


Specific instructions for receiving and applying program update service and for rebuilding components 
afterwards are found in Chapter 9 through Chapter 17. 


Corrective Service Overview | a 


Corrective service is service IBM sends you to correct a specific problem that you or another customer has 
encountered and reported. It is sent on a corrective service tape, which has the same format as the program 
update tape. It is applied the same way as program update service (see “Program Update Service Overview” 
on page 357), except that service is loaded and applied to the LOCAL! disks instead of the DELTA1 and 
APPLY disks. This is accomplished by redefining the DELTAI and APPLY disk strings to be the same as 
the LOCALI disk string in the override section of the product parameter file. (See “The Product Parameter 
File” on page 401.) 


Specific instructions for receiving and applying corrective service and for rebuilding components afterwards | 
are found in Chapter 9 through Chapter 16. \ 


Local Service Overview 


Local service is any service that is not supplied on a program update tape or corrective service tape. It can 
be service that you originate, or service that is sent to you by IBM to correct or circumvent a specific 
problem that you have encountered and reported. Circumventive service is sometimes read to you by an 
IBM service representative over the telephone. 


Changes to the system are provided as new parts, replacement parts, or changes (updates) to existing parts 
initially shipped on the product tape. They include: 


e Updates to an assembler source file (filetype is ASSEMBLE), macro (filetype is MACRO), control block 
(filetype is COPY), EXEC (filetype is SEXEC), or XEDIT macro (filetype is $XEDIT) 


¢ Replacement of existing object code (filetype is usually TXTnnnnn), EXECs (filetype is EXEC), XEDIT 
macros (filetype is XEDIT) HELP files, TXTLIB files, or. MODULE files 


¢ Patches to a text file (filetype is usually TXTnnnnn) for which there is no assembler source file. 


You will perform the following general steps manually for local maintenance: 
1. Receive the following files to the alternate LOCALI disk: 
e Source update files 


¢ Replacement files. 
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2. Apply the fixes by creating auxiliary control files on the alternate LOCALI disk. 


3. Build these changes into a alternate running system on the new BUILD 1 disk. 


Go to Chapter 18, “Receiving and Applying Local Service” on page 565 and follow the instructions for 


applying local service. Each chapter also gives instructions on how to build, test, and finally save your new 
system. 
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The MAINT Virtual Machine 


By convention, the MAINT virtual machine is used to perform installation and service tasks. (Your 
installation may use a different virtual machine.) MAINT’s directory entry is part of the sample file, USER 
DIRECT, that is supplied with the starter system. The sample directory is printed in Appendix C, “VM/XA 
System Product Starter System Information” on page 747. You may wish to alter MAINT’s virtual machine 
configuration, but remember that IBM created the configuration with the service process in mind. 


Minidisks form an important part of MAINT’s configuration. The strategy IBM follows is to separate key 
files onto different minidisk strings. A string is a set of minidisks defined in the product parameter file (see 


“The Product Parameter File” on page 401) for a particular use. The different strings defined in the product — 


parameter file are: 


String Use 

TASK Files to be accessed after the A-disk and before the component data base (for example, a 
service execs disk) 

BASEI1 Object code 

BASE2 Source code 


DELTA! Updates and replacement parts from the program update tape 
APPLY Auxiliary control files generated by the VMFAPPLY EXEC 
LOCALI Updates, replacement parts, and auxiliary control files for corrective service and local service 


BUILDI The system built from the base code on the BASE disks plus the updates on the DELTAI and 
| LOCAL] disks 


BUILD2-n System disk extensions—exact use varies by component. (For CMS, the HELP files are here.) 
SYSTEM  CMS-related files | 


When there is more than one minidisk in a string, you can use one for your current system and one, holding 
files from previous service levels, for an alternate system. 


MAINT’s service minidisks are described in Table 10 on page 361. 
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Table 10 (Page 1 of 3). MAINT’s Minidisks for System Service 


0294 CP current DELTAI muinidisk 


CMS, LOCAL]! | 0395 CMS corrective service DELTA disk. This disk is treated as part of 
DV the LOCAL disk string during PUT service and as part of both the 
DELTA and APPLY strings during corrective service. 
APPLY 
DELTAI 
BASE1 
BASE2 
BUILDI 
BUILD2 
BUILD3 
: BUILD4 
SYSTEM 
0194 CP current BASE] minidisk 
Note: For the CMS and DV components, the minidisks on the SYSTEM string are required for access 
to CP’s MACLIBs. 


0691 Minidisk with customized files for CMS and samples for DMSNGP 


and local service. This disk is treated as part of the LOCAL disk 


string during PUT service and as part of both the DELTA and 
APPLY strings during corrective service. 


0391 Cumulative merge of previous levels of CMS LOCAL] disks. This 
disk is treated as part of the LOCAL disk string during PUT service 
and as part of both the DELTA and APPLY strings during corrective 


Service. 


0692 New CMS control disk containing CMS AUX files which have been 
generated from text files by VMFAPPLY 


0392 
0593 


Cumulative merge of previous levels of CMS APPLY disks 


CMS text files or update files containing program temporary fixes 
(PTFs—also known as CMS service files) and auxiliary control files 
(AUXXA files) from the PUT 


Cumulative merge of previous levels of CMS DELTAI disks 


0293 


0193 CMS text file retention, CMS generation and utility tools, IOCP, and 
the dump viewing facility | 


0393 
0490 


CMS source file retention, macro definitions, and control blocks 


New CMS system disk containing CMS modules, control file, and 
CMS MACLIBs 


New mixed-case American English HELP files for CP, CMS, and GCS 
New CMS system disk for EREP files 

New uppercase American English HELP files for CP, CMS, and GCS 
MAINT’s work minidisk 

CP alternate LOCALI minidisk 

CP intermediate alternate LOCALI minidisk 

CP current LOCAL1 minidisk 

CP alternate DELTAI minidisk 


049D 
0501 
049C 
0191 
0295 
0591 
0291 
0594 
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Table 10 (Page 2 of 3). MAINT’s Minidisks for System Service 7 22 


te CP. 


LOCALI | 0295 CP corrective service DELTA disk. This disk is treated as part of the 


LOCAL disk string during PUT service and as part of both the 
0591 


DELTA and APPLY strings during corrective service. 


Customized files for CP, HCPBOX, HCPRIO, HCPSYS, and USER 
DIRECT files, and local service. This disk is treated as part of the 
LOCAL disk string during PUT service and as part of both the 
DELTA and APPLY strings during corrective service. 


| 0291 Cumulative merge of previous levels of CP LOCAL] disks. This disk 
is treated as part of the LOCAL disk string during PUT service and as 
part of both the DELTA and APPLY strings during corrective service. 
APPLY 0492 New CP control disk containing CP AUX files which have been 
| generated from text files by VMFAPPLY 
0192 Cumulative merge of previous levels of CP APPLY disks -_ 
XG, aot 


DELTAI | 0594 CP text files or update files containing program temporary fixes 
(PTFs—also known as CP service files) and auxiliary control files 


(AUXXA files) from the PUT 
Cumulative merge of previous levels of CP DELTAI disks 
CP text file retention, CP load list and control file, and CP MACLIBs 


0294 
0194 


0394 


a 
a 


BASE1 
BASE2 

BUILD2 
BUILD3 
BUILD4 


CP source file retention, macro definitions, and copy files | 
049D New mixed-case American English HELP files for CP, CMS, and GCS 
049C New uppercase American English HELP files for CP, CMS, and GCS 


0490 New CMS system disk containing CMS modules, control file, and 
CMS MACLIBs 


SYSTEM ; 0191 MAINT’s work minidisk 
| 0395 CMS alternate LOCALI minidisk 
0691 CMS intermediate alternate LOCAL] minidisk 
0391 CMS current LOCAL] minidisk -_ 
0593 | CMSalternate DELTA minidisk — 
0293 CMS current DELTAI1 minidisk 
0193 CMS current BASE]! minidisk 


Note: For the CP component, the minidisks on the SYSTEM string are required for access to the service 
EXECs. If you set up a service EXECs build disk on the TASK disk string, you can remove all 
but the 191 disk from the SYSTEM disk string. | 


SS 
— 
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Table 10 (Page 3 of 3). MAINT’s Minidisks for System Service 


GCS LOCALI | 0495 GCS corrective service DELTA disk. This disk is treated as part of 
the LOCAL disk string during PUT service and as part of both the 
DELTA and APPLY strings during corrective service. 


0491 Current GCS local service disk. This disk contains the cumulative 
merge of both the 495 and 791 from previous levels. This disk is 


treated as part of the LOCAL disk string during PUT service and as 
part of both the DELTA and APPLY strings during corrective service. 


0791 New GCS local service disk. This disk is treated as part of the 
LOCAL disk string during PUT service and as part of both the 
DELTA and APPLY strings during corrective service. 
APPLY 0592 GCS current cumulative merge of AUX files which have been 
generated by VMFAPPLY and UPDATE shells created by VMFREC 
0892 New GCS AUX files which have been generated by VMFAPPLY and 
UPDATE shells created by VMFREC 


DELTAI | 0596 GCS current cumulative merge of text files, update files and AUX files 
from previous levels of PUT 


0896 New GCS text files, update files and AUX files 


BASE1 0595 GCS text file retention, GCS load list, control file, and GCS 
MACLIBs 


BUILD 1 0895 New GCS system 
BUILD2 O89E New GCS system extensions 


BUILD3 049D New mixed-case American English HELP files for CP, CMS, and GCS 
BUILD4 049C New uppercase American English HELP files for CP, CMS, and GCS 
BUILD5 0490 


New CMS system disk containing CMS modules, control file, and 
CMS MACLIBs 


MAINT’s work minidisk 

CMS alternate LOCALI minidisk 

CMS intermediate alternate LOCAL]! minidisk 
CMS current LOCALI minidisk 

CMS alternate DELTAI minidisk 

CMS current DELTAI minidisk 

CMS current BASE! minidisk 


SYSTEM | 0191 
0395 
0691 
0391 
0593 
0293 
0193 


Note: For the GCS component, the minidisks on the SYSTEM string are required for access to the 
service EXECs. If you set up a service EXECs build disk on the TASK disk string, you can 
remove all but the 191 disk from the SYSTEM disk string. 


MAINT’s minidisk configuration allows a multilevel updating scheme that preserves the data integrity of the 
source code and allows you to build a system with the latest updates. The organization of MAINT’s 
minidisks is shown in Figure 6 on page 364. This layout allows you to build a new system on the alternate 
minidisks without altering your running system and lets you back out to the old system if necessary. When 
you are satisfied with your new system, the alternate disks are copied to the current system’s disks so that the 
alternate disks can be used to build your next system. 7 
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Figure 6. Alternate, Intermediate Alternate, and Current Minidisks for System Service 
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The disk layout in Figure 6 on page 364 is created on the following principles: 


1. Never change anything IBM sends you. To be sure that you don’t, never write-link to a disk you don’t 
want to write on. The BASE disks are read-only during service. The DELTA disks are read-only except 
when VMFREC and VMFAPPLY are running. 


2. Keep components separate from each other, so that (for example) changes to CP will not affect CMS. 


3. Keep locally applied service and corrective service separate from PUT service, so that changes to the 
LOCAL disk will not inadvertently change IBM service on the DELTA disk. 


4. Keep base release installation separate from service, so that changes to the LOCAL disk or VMFREC 
will not inadvertently change the original product as installed on the BASE disks. 


5. Keep alternates for LOCAL and DELTA disks so that you can back out. 


Plan for backout in case something goes wrong when you apply service. Alternates make reconstruction 
of the previous level easier. 


6. Keep an alternate BUILD disk. 


Don’t change the system while it is running. An alternate BUILD disk minimizes the amount of 
reconstruction necessary to back out. 


Figure 7 shows the system disks accessed during the process of applying service to CP and CMS. This is 
done while the system is running in a CMS environment. The current system disks are not changed by 
service and remain accessed at all times. The service process builds the new system on the alternate system 
disks, which will be copied to the current system disks to make room for the next service cycle when the 
service process is complete and stabilized. 


BUILD1 BUILD2 BUILD4 


S-Disk S-Disk Extension Work AMENG Help UCENG Help 


Alternate system 


Current system 


Figure 7. Minidisks for Running CMS 


The system alternate disks are the BUILD disks in Figure 6 on page 364. They are shown here to emphasize 
the fact that the service process builds on a set of disks separate from the running disks. 
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Tools and EXECs Used During the Service Process 


You need to use many different programs and EXECs during the service procedure. Below i is a list of the 
programs and EXECs you will use: 


VMFREC 


VMFAPPLY 


VMFMAC 


VMFNLS 


VMFHASM 


VMFBLD 


VMFOVER 


VMFPLC2 


VMFSETUP 


VMFVIEW 


Use VMFREC to load product service from a tape to your system. This EXEC is required 
for VM/XA System Product service. It is compatible with VMSERV and existing product 
service EXECs. You can use it to load the tape document and all Memos to Users for that 
tape as well as to map the tape. The map is compatible with VMSERV. 


For more information on VMFREC, see “VMFREC EXEC” on page 709. 


Use VMFAPPLY with the APPLY list to create AUX files for those PTFs being added to 
your system. | | 


For more information on VMFAPPLY, see “VMFAPPLY EXEC” on page 672. 
The VMFMAC EXEC updates and rebuilds macro libraries. 
For more information on VMFMAC, see “VMFMAC EXEC” on page 688. 


The VMFNLS EXEC updates national language-related files, for example, message 
repositories. 


For more information on VMFNLS, see “VMEFNLS EXEC” on page 698. 


-VMFHASM invokes the UPDATE command to automatically incorporate update files for a 


particular ASSEMBLE file into a temporary copy of the ASSEMBLE file, then invokes the 
H Assembler to assemble the copy. The assembled files (called TEXT files) are used when 
the system is regenerated by the VMFBLD EXEC. 


For more information on VMFHASM, see “VMFHASM EXEC” on page 684. 


Use VMFBLD to build the nucleus parts of VM/XA System Product. 


For more information on VMFBLD, see “VMFBLD EXEC” on page 679, 


The VMFOVER EXEC makes a temporary copy of one component section from the aia 
parameter file with changes made in accordance with the override section of the product 
parameter file or a separate PPF override file. The other service and installation EXECs use 
this copy instead of the base product parameter file. 


For more information on VMFOVER, see “VMFOVER EXEC” on page 703. 


VMFPLC2 loads all or a specified number of files from tape. Directions for its use as a 
command appear in the PUT document; it is also automatically invoked by VMFREC, 
VMSERYV, and product service EXECs. 


For more information on VMFPLC2, see “VMFPLC2 Command” on page 705. 


The VMFSETUP EXEC is invoked by the other service EXECs to set up the minidisk access 
order. 


For more information on VMFSETUP, see “VMFSETUP EXEC” on page 722. 


The VMFVIEW EXEC invokes XEDIT to allow you to view the exception logs. Using the 
VMFVIEW EXEC’s PF key assignments, you can view all the messages of a specific type, all 
the messages of a specific number, the HELP screen for a particular message, and move 
backwards and forwards through the displayed exception log. 


For more information on VMFVIEW, see “VMFVIEW EXEC” on page 724. 
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VMSERV VMFREC has superseded VMSERV, but you may continue to use the VMSERV EXEC to 
install products other than VM/XA System Product from the PUT. This EXEC is in the first 
file on a PUT; it can be used to print the PUT document and all memos to users for that 
PUT. 


XEDIT XEDIT is the CMS editor shipped with VM/XA System Product. Use it to create control 
files in the local service procedure. 


If you need information on using XEDIT, please see VM/XA SP System Product Editor 
Command and Macro Reference, or VM/XA SP System Product Editor User's Guide. 


“MAP 0001: Select a Service Procedure,” “MAP 0004: Apply Local Service” on page 370 , “MAP 0003: 

Apply Program Update Service or Corrective Service” on page 368, and “MAP 0005: Build the System” on 
page 371 outline the service process, showing when you will need to use the key service EXECs. The service 
maps also refer you to the exact places in Chapter 9 through Chapter 16 where the major steps are detailed. 


Note that the essential differences between applying program update service or corrective service and 
applying local service are in the manner of receiving and applying service. For all kinds of service, the system 
is built in the same way. 


For program update service of products other than VM/XA System Product Release 2, the product build 
EXEC is invoked by issuing the VMFBLD EXEC for the product. 


MAP 0001: Select a Service Procedure 


Have you read Chapter 6, “VM/XA System Product Service—An Overview” on page 355, Chapter 7, “How 
VM/XA System Product Uses Control Files and Update Files” on page 377, and Chapter 8, “Files Used in 
Program Update Service and Corrective Service” on page 385? 

Yes No 


— Read those chapters before you do anything else. 
003 


Is the service on either a program update tape or corrective service tape? 
Yes No 


— Go to “MAP 0004: Apply Local Service” on page 370. 


— Go to “MAP 0002: Receive Program Update Service or Corrective Service” on page 368. 
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MAP 0002: Receive Program Update Service or Corrective Service 


001 


~ VMFREC EXEC 


CMS Chapter 9, “Receiving Program Update Service or Corrective Service for CMS” on page 435 

CP Chapter 10, “Receiving Program Update Service or Corrective Service for CP” on page 443 

DV Chapter 15, “Program Update Service or Corrective Service to the Dump Viewing Facility,” “Step 2. 
Receive Service” on page 539 

GCS Chapter 16, “Program Update Service or Corrective Service to GCS,” “Step 2. Receive Service” on 


page 549 =. 8 
Are you servicing both CP and CMS? 
Yes No 

002 


— Go to “MAP 0003: Apply Program Update Service or Corrective Service.” 
003 


Have you run VMFREC to receive both CP and CMS service? 
Yes No | 


— Go back to Step 001. 


If you are servicing both CP and CMS, you must receive service for both components before you apply 
service to either. | 


~— Go to “MAP 0003: Apply Program Update Service or Corrective Service.” 


MAP 0003: Apply Program Update Service or Corrective Service 


001 


Are you servicing VM/XA SP? 
Yes No 


— PRODUCT SERVICE EXEC 


See the documentation for the specific product. 


003 
(Step 003 continues) 
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003 (continued) 


Are you servicing CP? 
Yes No 


— Continue with Step 009. 


Are you also servicing CMS? 
Yes No 


— Continue with Step 009. 
007 


Have you already applied service to CMS? 
Yes No 


008 


— STOP. 
If you are servicing both CP and CMS, you must apply service to CMS before you apply service to CP. 


— VMFAPPLY EXEC 


CMS Chapter 11, “Applying Program Update Service or Corrective Service to CMS” on page 449 
CP Chapter 12, “Applying Program Update Service or Corrective Service to CP” on page 453 
DV Chapter 15, “Step 3. Apply the Updates” on page 541 

GCS Chapter 16, “Step 3. Apply the Updates” on page 551 


Are you servicing both CP and CMS? 
Yes No 


010 
— Go to “MAP 0005: Build the System” on page 371. 
O11 


Have you run VMFAPPLY to apply service to both CP and CMS? 
Yes No 


012 


— Go back to Step 009. 


If you are servicing both CP and CMS, you must apply service to both components before you build 
either. 


Chapter 6. VM/XA System Product Service—An Overview 369 


MAP 0003 (continued) 


013 


— Go to “MAP 0005: Build the System” on page 371. 


MAP 0004: Apply Local Service 
001 


Is the service in update form? 
Yes No 


— Continue with Step 004. 
003 


— Apply the update manually. 
Chapter 18, “Receiving and Applying Local Service,” “Step 3. Apply Service” on page 570 


004 


Is the service either a patch or a ZAP? 
Yes No 


— Apply the update manually. 
Chapter 18, “Receiving and Applying Local Service,” “Step 3. Apply Service” on page 570 


— Go to “MAP 0005: Build the System” on page 371. 


Are you servicing the nucleus? 
Yes No 


007 


— VMFZAP EXEC 
Appendix B, “EXEC and Command Format Summaries,” “WMFZAP EXEC” on page 729 
— Go to Step 009 on page 371. | 


008 


— Patch Facility 
Chapter 19, “Emergency Local Service Using the Patch Facility” on page 577 
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Are you servicing both CP and CMS? 
Yes No 


010 


— Go to “MAP 0005: Build the System.” 


O11 


Have you applied local service to both CP and CMS? 


Yes No 


012 


— Go back to Step 001 on page 370. 


If you are servicing both CP and CMS, you must apply service to both components before you build 


either. 
013 


— Go to “MAP 0005: Build the System.” 


MAP 0005: Build the System 


Are you servicing CP? 
Yes No 


002 


— Continue with Step 007 on page 372. 


003 


Are you also servicing CMS? 
Yes No 


— Continue with Step 007 on page 372. 


(Step 005 continues) 
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MAP 0005 (continued) 


005 (continued) 


Have you already built CMS? 
Yes No 


— STOP. 
If you are servicing both CP and CMS, you must build CMS before you build service to CP. 


007 


Are you servicing macros? 


Yes No 


008 


— Continue with Step 010. 


— VMFMAC EXEC 


CMS Chapter 13, “Rebuilding CMS after Applying Service,” “Step 1. Build a New CMS Macro Library” 
on page 458, “Step 2. Build a New CP Macro Library” on page 461 

CP Chapter 14, “Rebuilding CP after Applying Service,” “Step 2. Build a New CP Macro Library” on 
page 518 | . 

GCS Chapter 16, “Step 4. Build a New GCS Macro Library” on page 552 


Are you servicing the message repository? 
Yes No 


011 
— Continue with Step 013. 
012 


— VMFNLS EXEC 


CMS Chapter 13, “Step 3. Update the CMS Message Repository” on page 464 
CP Chapter 14, “Step 3. Update the CP Message Repository” on page 521 
GCS Chapter 16, “Step 5. Update the GCS Message Repository” 


013 
(Step 013 continues) 
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013 (continued) 


Are you servicing an ASSEMBLE file? 
Yes No 


014 
— Continue with Step 016. 
015 


— VMFHASM EXEC ” 


CMS Chapter 13, “Step 4. Assemble the Changed ASSEMBLE Files” on page 465 
CP Chapter 14, “Step 4. Assemble the Changed ASSEMBLE Files” on page 522 
GCS Chapter 16, “Step 6. Assemble and Build the GCS Nucleus” (substep 6 on page 556) 


016 


Are you servicing the nucleus? 
Yes No 


017 


— Continue with Step 019. 


— VMFBLD EXEC 


CMS Chapter 13, “Step 5. Build the Nucleus” on page 467 
CP Chapter 14, “Step 5. Build the CP Nucleus” on page 523 
GCS Chapter 16, “Step 6. Assemble and Build the GCS Nucleus” (substep 11 on page 557) 


019 


Are you servicing either CP or the dump viewing facility? 
Yes No 


020 
— Continue with Step 022. 
021 


— UTILITY EXEC 


CP Chapter 14, “Step 8. Build Utilities” on page 530 
DV Chapter 15, “Step 4. Build the Dump Viewing Facility” on page 542 


022 
(Step 022 continues) 
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MAP 0005 (continued) 


022 (continued) 


Are you servicing CMS? 
Yes No 


023 
— Continue with Step 025. 
024 


— CMSGEND EXEC 
CMS Chapter 13, “Step 6. Generate Executable Modules” on page 469 


025 


Are you servicing System Product Interpreter programs (EXECs or XEDIT macros)? 


Yes No 


— Continue with Step 028. 
027 


— EXECUPDT EXEC 


CMS Chapter 13, “Step 7. Regenerate System Product Interpreter Programs” on page 474 
CP Chapter 14, “Step 9. Regenerate System Product Interpreter Programs” on page 533 
DV Chapter 15, “Step 5. Regenerate System Product Interpreter Programs” on page 543 


028 


— Build test CMS named saved systems. 
All Chapter 13, “Step 10. Build Test Named Saved Systems” on page 481 


Are you servicing CMS? 
Yes No 


@ 
— Go to Step 031 on page 375. 
030 


— Install test saved segments. 


CMS Chapter 13, “Step 11. Install Test CMSDOS, CMSBAM, CMSVSAM, and CMSAMS Saved 
Segments” on page 484, “Step 12. Install Test CMSINST and HELP Saved Segments” on page 491 
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031 


— Test the new CMS system. 
All Chapter 13, “Step 13. Test the System” on page 495 


Does it work? 
Yes No 


032 
— Correct the problem and try again. 
033 


— Purge CMS test named saved systems and saved segments. 

All Chapter 13, “Step 14. Purge the Test Named Saved Systems and Saved Segments” on page 496 
— DDR alternate CMS system disks to current CMS system disks. 

All Chapter 13, “Step 15. DDR Alternate Disks to System Disks” on page 497 

— Rebuild the CMS nucleus (VMFBLD EXEC) 

All Chapter 13, “Step 16. Rebuild the Nucleus” on page 499 

— Rebuild CMS named saved systems. 

All Chapter 13, “Step 17. Rebuild Named Saved Systems” on page 501 


Are you servicing CMS? 
Yes No 


034 
— Go to Step 036. 
035 


— Reinstall saved segments. 


CMS Chapter 13, “Step 18. Reinstall the CMSDOS, CMSBAM, CMSVSAM, and CMSAMS Saved 
Segments” on page 504, “Step 19. Reinstall the CMSINST and HELP Saved Segments” on page 510 


036 


— Back up the new system. 


CMS Chapter 13, “Step 20. Back Up the Named Saved Systems” on page 514 

CP Chapter 14, “Step 11. Back Up the CP System” on page 536 | 

DV Chapter 15, “Step 7. Back Up the Dump Viewing Facility” on page 546 
GCS Chapter 16, “Step 9. Back Up the GCS Named Saved Systems” on page 561 


You have finished the service process. 
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Chapter 7. How VM/XA System Product Uses Control Files 
and Update Files 


This chapter describes: 


¢ What control files, auxiliary control files, and update files are 


e File-naming conventions used in VM/XA SP service procedures 


¢ How different control files can be used to create different systems. 


The VM/XA System Product service process relies heavily on CMS files called control files. Each component 
of VM/XA System Product has at least one control file structure. 


There are control files, auxiliary control files, and the actual update files (also called service files). These files 
may have the following generic filetypes: 


Filetype File Contents 

CNTRL Control file 

AUXXxxxx Auxiliary control file. xxxxx is up to five alphabetic or numeric characters. 
UPDTxxxx Update (listed in a CNTRL file; this is not recommended because it makes tracking 


difficult). xxxx is up to four alphabetic or numeric characters. 


Hmmmmnmxx Update (listed in an AUX file). mmmmm is an APAR number and xx is HP (for CP 
and dump viewing facility assembler source and object updates), PP (for other CP and 
dump viewing facility object updates), DS (for CMS modules), or CI (for GCS). 


TmmmmmDS CMS macro update (listed in an AUX file). mmmmm is an APAR number. 


Control files may be extremely simple or quite elaborate, but their important function is to allow you to 
control those changes necessary to tailor your system to meet your current needs. Each structure of control 
files is a tree with the main control file at the base, auxiliary control files branching off from the main control 
file, and update files branching off from the auxiliary control files. 


Figure 8 on page 378 shows the main CP control file, along with two auxiliary control files and their 
corresponding update files. (There are actually many auxiliary control files with update files). The control 
file HCPXA CNTRL contains several lines, one of which is the filetype of the VM/XA SP auxiliary control 
files (AUXXA). Every assemble file, macro, control block file, EXEC, or XEDIT macro, that has had 
service applied to it has a corresponding auxiliary control file called fn AUXxxxxx, where fn is the filename 
of the file that has been serviced. (For example, the auxiliary control file for program update service to 
HCPXXX ASSEMBLE is HCPXXX AUXXA.) Each auxiliary control file, in turn, contains the filetypes of 
the update files that have been applied. 


Figure 8 on page 378 applies to all components of VM/XA SP. The structure for all components is 


identical, except that the main control filename and update file suffix vary (for example, the CMS main 
control file is called DMSXA CNTRL instead of HCPXA CNTRL; and the update file suffix is DS). 
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Control file Auxiliary control files Update files 


HCPXA CNTRL HCPXXX AUXXA 


AUXXA H12345HP HCPXXX H12345HP 


H12346HP 


HCPXXX H12346HP 


pee ne HCPYYY H56789HP 


a 
— 


Figure 8. Service File Structure 


Control Files 


Control files are used in: | \ 


Updating assembler source files and EXECs using XEDIT 
Updating control blocks and macros using XEDIT 

Creating and updating AUX files using VMFAPPLY 
Assembling source code using the VMFHASM EXEC procedure 
Patching object code using the PATCH facility 

Building MACLIBs using the VMFMAC EXEC procedure 
Regenerating updated EXECs using EXECUPDT 

Creating an executable CP or CMS nucleus using VMFBLD 
Generating CP utilities using UTILITY : 
Generating CMS modules using CMSGEND. \e_/ 


Control files are used by the CMS UPDATE command. The EXECUPDT, XEDIT, VMFMAC, and 
VMFHASM procedures invoke UPDATE with the CTL option to modify source files. The VMFAPPLY, 
VMFBLD, and HCPLDR programs also use the control file structure directly; usually the same control file is 
used by all these procedures for a given product or component. For the purposes of product service, all the 
procedures require that the control file must have a filetype of CNTRL. The control filename is unique for 
each VM/SP XA component. The VM product control filenames and their contents are provided in “Main 
Control Files” on page 380. 


a 
| H 


Sample Control File 
For an understanding of how the update procedures work, you should be familiar with the elements in a 
control file. A control file for the VM/XA System Product system might look like Figure 9 on page 379. 
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*THIS IS A SAMPLE CNTRL FILE FOR LOCAL CP UPDATES 
*DO NOT USE THIS FILE 

TEXT MACS HCPXA1 HCPXA2 CPLIB DMSSP CMSLIB OSMACRO 
LOC] AUXLCL LCL TX$ * COMMENT 

TEXT AUXXA 


Figure 9. Sample Control File 


There are usually three kinds of records in a control file: MACS records, AUX file identification records, 
and comments. (A fourth kind, update file identification records, will work but should be avoided.) 


MACS Records 


A control file can have any number of MACS records. They must appear before any AUX file identification 
records. The first field in the MACS record is the update level identifier. You can think of this as a name 
field. If no update files are found, the filetype of the assembled text deck will be derived from the update 
level identifier on the MACS record: TEXT if the update level identifier is TEXT and TXTxxxxx, where 
xxxxx 18 the update level identifier, if it is anything else. 


The remaining fields in the MACS record are the names of macro libraries. There may be up to eight macro 
library names on a single MACS record. VMFHASM uses the library list from the MACS record to issue a 
GLOBAL command before assembling the updated source file. The libraries are searched in the order 
specified. 


AUX File Identification Records 


A control file can have any number of AUX file identification (AUXxxxxx) records. The first field in an 
AUX file identification record is the update level identifier. If the auxiliary control file named in this record 
is found, but the top entry in the auxiliary control file contains no PTF number or local tracking number, the 
filetype of the assembled text deck will be derived from the update level identifier on the AUX file 
identification record: TEXT if the update level identifier is TEXT and TXTxxxx, where xxxx is the update 
level identifier, if it is anything else. (If more than one auxiliary control file is listed, the last one found—the 
one named on the top auxiliary control file identification record—determines the text deck filetype.) 


The second field (sometimes called the update ID) is the filetype of the auxiliary control file. The characters 
AUX identify an auxiliary control file that lists additional fixes to be applied; AUXLCL in this example. 
AUXXA is the VM/XA System Product auxiliary control file, listing updates distributed by IBM. This file is 
listed at the bottom of the control file so that these updates are applied first. (Note that the file is read from 
the bottom to the top by UPDATE and from the top to the bottom by VMFBLD. UPDATE applies IBM 
changes first and local changes last, while VMFHASM names the text file, and VMFBLD finds it, according 
to the last change applied.) 


Note: Service supplied by IBM for VM/XA System Product does not use preferred AUX files, but they are 
supported. If you wish to use them, see “Preferred AUX File” on page 665. 


The third and fourth fields are optional. Both are 3-character fields. Either one may come first. One of 
them (for example, LCL in the third line of Figure 9) is the text deck filetype prefix. If the auxiliary control 
file corresponding to this record is the last file found, and if it contains a PTF number or appropriate local | 
tracking number, the filetype of the assembled text deck will be xxxnnnnn, where xxx is the text deck filetype 
prefix and mnnnn is the five numeric digits (the last five characters) of the PTF number or local tracking 
number. (If no number is found, an error is signaled.) The letters LC in a text deck filetype prefix indicate a 
local fix. (All prefixes that do not begin with LC are reserved for IBM use.) The default text deck filetype 
prefix is TXT. 
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If the other 3-character field (usually placed after the text deck filetype prefix) 1 iS present, it contains the 
keyword TX$, indicating a patch. 


Comments 
A control file can have any number of comment records. Comment records are identified by an asterisk (*) 


in the first column. They may appear anywhere in the control file. Comments may also appear at the end of 
control records. They begin with an asterisk. | 


_ Update File Identification Records 


For compatibility with other VM systems, VM/XA System Product also supports update file identification 
records in control files. Avoid using them if possible, because an update listed in a control file must be called 
UPDTxxxx. The four variable characters are not enough to identify the APAR with which this update is 
associated, essential information for tracking. List updates in an auxiliary control file, where the name can 
include an APAR number. 


Varying Control Files to Generate Multiple Systems 


By varying the control files, you can build different versions of your system from a single set of AUX and 
update files. For example, you might have the following files: , 


Filename Filetype Contents 


PRODSYS CNTRL *THIS IS A SAMPLE CNTRL FILE 
*DO NOT USE THIS FILE 
TEXT MACS HCPXA1 HCPXA2 CPLIB DMSSP CMSLIB OSMACRO 
LC2 AUXLCL2 LCL TX$ 
P1 AUXP1 
TEXT AUXXA 


TESTSYS CNTRL  *THIS IS A SAMPLE CNTRL FILE 
*DO NOT USE THIS FILE 
TEXT MACS TESTLIB HCPXA1 HCPXA2 CPLIB DMSSP CMSLIB OSMACRO 
LC1 AUXLCL1 LCT TX$ * FREE FORM COMMENT 
LC2 AUXLCL2 LCL TX$ 
P1 AUXP1 
TEXT AUXXA 


Notice that the control file for the test system contains one more level of updates (the record beginning with 
LC1) than the control file for the production system. When all the updates listed in the auxiliary control files 
have been applied, the system built with the test control file will contain more updated files than the system 
built with the production control file. Both control files serve as the base of a tree using the same set of 
AUX and update files, but the test tree has branches not in the production tree. It is not necessary to keep 
two sets of AUX and update files. 


Notice also that the test system includes one more macro library (TESTLIB) than the production system. — 


Main Control Files 


CP, CMS, CMS macros, the dump viewing facility, GCS, and the VM/XA SP loader each have a main 
control file. The contents of these main control files are shown below. 
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The contents of HCPXA CNTRL (control file for CP) are: 


TEXT MACS HCPXA1 HCPXA2 CPLIB DMSSP CMSLIB OSMACRO 
PAT AUXPAT TX$  * Local Patches 
LCL AUXLCL LCL * Local Modifications 
COR AUXCOR * IBM Corrective Service 
* 
* 


SUP AUXSUP SUP Reach Ahead 
TEXT AUXXA IBM Put Service 


The contents of DMSXA CNTRL (control file for CMS) are: 


TEXT MACS DMSSP CMSLIB OSMACRO DOSMACRO CPLIB TSOMAC 
PAT AUXPAT TX$ * Local Patches 

LCL AUXLCL LCL * Local Modifications 

COR AUXCOR * IBM Corrective Service 

SUP AUXSUP * SUP Reach Ahead 

TEXT AUXXA * IBM Put Service 


The contents of DMSMXA CNTRL (control file for CMS macros) are: 


( TEXT MACS 
- PAT AUXMPAT TX$ * Local Patches 
LCL AUXMLCL LCL * Local Modifications 
COR AUXMCOR * IBM Corrective Service 
SUP AUXMSUP * SUP Reach Ahead 
TEXT AUXMXA * IBM Put Service 


The contents of HCSXA CNTRL (control file for dump viewing facility) are: 


_ TEXT MACS HCPXA1 HCPXA2 CPLIB DMSSP CMSLIB OSMACRO 
( 4 PAT AUXPAT TX$  * Local Patches 
aout LCL AUXLCL LCL * Local Modifications 
COR AUXCOR * IBM Corrective Service 
SUP AUXSUP * SUP Reach Ahead 
TEXT AUXXA * TBM Put Service 


The contents of CSIXA CNTRL (control file for GCS) are: 


TEXT MACS CSISP DMSSP CMSLIB 
PAT AUXPAT TX$  * LOCAL PATCHES 
a LCL AUXLCL LCL * LOCAL MODIFICATIONS 
( COR AUXCOR * TBM CORRECTIVE SERVICE 
Lo SUP AUXSUP * SUP REACH AHEAD 
TEXT AUXXA * TBM PUT SERVICE 


The contents of HCPLDRCM CNTRL (control file for the VM/XA SP loader) are: 


TEXT MACS HCPLDRM HCPXA1 HCPXA2 CPLIB DMSSP CMSLIB OSMACRO 
TEXT AUXCMS 
TEXT AUXXA 


Notes: 


1. HCPLDRCM CNTRL is used only to assemble the VM/XA SP loader. 


2. All the service EXECs obtain the control filename from the product parameter file, except UTILITY 
EXEC, which always uses HCPXA CNTRL. HCPXA CNTRL is the usual control file for CP and for 
utilities. 
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Local Control Files 


The control files supplied by IBM already provide for one level of local service; but when you create files for 
local service or updates of VM/XA System Product modules, you may still need to create a local control file. 
A local control file is a copy of the appropriate VM/XA System Product control file with an entry for each 
local auxiliary control file and the filename of your local MACLIB. For example, the file CPLCL CNTRL 
may contain: | 


TEXT MACS YOURMAC HCPXA1 HCPXA2 CPLIB DMSSP CMSLIB OSMACRO 
LCT AUXLCT LCT * TEST UPDATES 

LCL AUXLCL LCL 

TEXT AUXXA 


Note: Control files (CNTRL) and auxiliary control files (AUXxxxxx) are read from the bottom up when 
updates are applied. The IBM-supplied auxiliary files should be the bottom entry in the control file so 
that during assembly the IBM updates are applied first. 


Auxiliary Control Files 


When auxiliary control files are distributed by IBM for VM/XA System Product, they have the filetype 
AUXXA. If an auxiliary control file is not distributed, it must be created by VMFAPPLY. Figure 10 shows 
a sample auxiliary control file for source updates. Figure 11 shows a sample auxiliary control file for patches 
to text decks. | 


Update ft PUT Level PIF # Comments 


(APAR #) 
H12567HP 801 ~-UM98765 * COMMENT DESCRIBING FIX 


Figure 10. Sample Auxiliary Control File for Source Updates 


Update ft Patch APAR # Comments 
(Patch #) Indicator 
P23877 TX$ VM23877 * A PATCH TO BE REPLACED BY APAR VM23877 


Figure 11. Sample Auxiliary Control File for Patches to Text Decks 


For local source updates, a local tracking number takes the place of the PTF number in the auxiliary control 
file. Like the PTF number, a local tracking number has seven characters (two letters followed by five 
numbers). 


When the text deck filetype is created, the two letters of the PTF number or local tracking number are 


ignored. The five numbers are appended to the text deck filetype prefix if one is present in the main control 
file. If no text deck filetype prefix is found, TXT is used as the prefix... 
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Update Files 


Update files can contain: 
¢ Updates to source code 
e Patches to object code 


e Prerequisite and corequisite information, without any patch or update. 


All of the PTF and update files distributed by VM/XA System Product are assigned filetypes as follows: 


Update File APAR Number PTF Number 


= 


HmmmmmPP 
HmmmmmDS 
HmmmmmCl 

TmmmmmDS 


where: 

H indicates a VM/XA SP update. 

T indicates a VM/XA SP CMS macro update. 

HP is the 2-character identifier for VM/XA System Product CP and dump viewing facility assembler 
source and object updates. 

PP is the 2-character identifier for other VM/XA System Product CP and dump viewing facility 
updates. 

DS is the 2-character identifier for VM/XA System Product CMS. 

CI is the 2-character identifier for VM/XA System Product GCS. 


mmmmm is an APAR number. You can enter the command FILELIST * *mmmmm* * to see a listing of 
| all the modules affected by APAR mmmmm. The filename is the same as the module name. 
Browse the AUX file for any one of these modules to find the corresponding PTF number. 


nnnnn is a PTF number. You can enter the command FILELIST * *nnnnn* * to see a listing of all the 
modules affected by PTF mnnnn. The filename is the same as the module name. Browse the 
AUX file for any one of these modules to find the corresponding APAR number. | 


For example, the code and fixes to answer APAR VM12567 against the CP module HCPCFM in VM/XA 
System Product are contained in the file HCPCFM H12567HP. 


The file HCPCFM AUXXA contains the entry: 
H12567DK 801 UM98765 *COMMENT DESCRIBING FIX 


UM98765 is the PTF corresponding to APAR VM12567. If UM98765 is the last PTF applied to HCPCFM, 
the assembled text deck will be called HCPCFM TXT98765. 


For your local updates, assign a local tracking number with the format LCnnnnn, where the prefix LC 


indicates a local fix. The five numeric digits of the local tracking number can be used to name text decks in 
the same way as the five numeric digits of the PTF number. 
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Guidelines for Using Update Files | 
1. 


2. Keep all local fix descriptions for the same part in the same AUX file, unless a fix applies to a different 
control file level. | 
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Keep each fix (patch or APAR) in a separate update file. This applies to both source update and patch _ 
fixes. You may have several files containing the same fix (this happens when the same fix applies to 
several parts), but you must never have several fixes in the same file. 


Each fix should have a unique identifier for control purposes. This identifier is the filetype of the update 
file. If the same fix applies to several parts, there should be a file for each part, all with the same 


filetype. 


Local fixes for the same part should not be distributed over AUX files (different control file levels) 
arbitrarily. Local service should be easily distinguished from IBM service and should always be applied 
last. Local service can be distributed over separate control files for the purpose of maintaining different 
service levels with a single structure of AUX and update files. Each level can be built from a different 
control file containing only the desired level identifiers. 


. Never place local patches in AUX files from IBM. In other words, keep your local service separate from 
IBM service. Local service should be easily distinguished from IBM service and should always be applied 


last. 


. Patches to text files should be applied only when no source file is available. If you do apply text file 
patches when source code is available, they should be converted to source updates and reassembled 
before they are moved from a test environment to a production-level system. 


Building local source updates on top of local text file patches for the same part will lead to confusion. 


. Do not place the names of update files directly in the main control file. Place update filenames in an 
auxiliary control file. 


If you place the update filename in the main control file instead of an auxiliary control file, the update 
file’s filetype must be UPDTxxxx. If you place it in an auxiliary control file, the update file’s filetype 
can be derived from the APAR number, and you can specify the text deck’s filetype (derived from the 
PTF number). These filetypes are used during assembly and nucleus build. 


Chapter 8. Files Used in Program Update Service and 
C Corrective Service 


This chapter describes: 


e The files used in applying program update service and corrective service 


e The program update tape (PUT) 


e The corrective service tape. 


Files Used in Program Update Service and Corrective Service 


Besides the source or object code to be updated, the following files are used to apply program update service 
and corrective service: 


PUT document 

COR document 

PUT descriptor file 

COR descriptor file 

Product contents directory 

Memo to Users 

Control file (see Chapter 7, “How VM/XA System Product Uses Control Files and Update Files” on 
page 377) 

Auxiliary control files (see Chapter 7, “How VM/XA System Product Uses Control Files and Update 
Files” on page 377) 

Update files, also called service files 
Update shells 

Text decks 

Text shells 

PTF parts list 

Apply list 

Exclude list 

Exception log 

Receive history file 

Load list 

Temporary load list 

Load map 

Restart indicator files 

$LEVEL MAP 

$LEVEL EXEC 

$LEVEL $TAPE 

Product parameter file 

Product parameter override file 
Temporary product parameter file 
Service disk map. 
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The PUT Document 


The PUT document describes the service procedure contained on the program update tape. It lists the steps 
involved in applying service to the system, and contains a description of the VMSERV EXEC. (Other service 
installation EXECs are described in the Memo to Users.) Read the PUT document before you try to apply 
service. | 


The COR Document 
The COR document describes the service procedure contained on the corrective service tape. It lists the steps 


involved in applying service to the system, and contains an explanation of the service EXECs. Read the 
COR document before you try to apply service. 


The PUT Descriptor File 


The PUT descriptor file is a directory of the products and components for which service is contained on the 
program update tape. It shows how many files are available for each product and component and where they 
are. The PUT descriptor file is called PUT nnnn, where nnnn is the PUT number. Figure 12 is an example 
of a PUT description file. 


Record One 
VM System Program Update Tape 

Record Two 
VOLnn of 03 

Record Three to n *** Multi-volume directory 
eVNI AI 


PUT FILES 02 
prodid1 HDR Q1 
prodid1l compl nn 
prodidl comp2 nn 
prodidl comp3 nn 
prodid2 HDR 01 
prodid2 compl nn 
prodid2 comp2 nn 
:VOLO2. 

PUT FILES 02 
prodid2 HDR 01 
prodid2 comp3 nn 
prodid2 comp4 nn 
prodid3 HDR 01 
prodid3 compl nn 
prodid3 comp2 nn 
:VOLO3. 

PUT FILES 02 
prodid3 HDR 01 
prodid3 comp2 nn 
prodid3 comp3 nn 


Figure 12. Example of a PUT Descriptor File 


The first record of the PUT descriptor file states that it applies to a program update tape. (This record 
distinguishes the PUT descriptor file from the COR descriptor file, described in “The COR Descriptor File” 
on page 387, which is very similar.) The second record tells how many volumes the tape has and which 
volume this is. If there is more than one volume, the PUT descriptor file appears on each volume, but 
describes the whole tape. 
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a 
fe \ 


Na y 


The other records describe the contents of the file. A :WOLnn record indicates the beginning of each volume. 
Each of the three-word records following a :VOLnn. record describes a group of tape files. (A tape file is the 
data between two tape marks. It may contain more than one CMS file.) If the first two words are PUT 
FILES, that group of files is the two standard tape files that begin every volume of the program update tape: 
one containing the PUT descriptor file, PUT document, and service EXECs, the other containing 
informational files about all the products for which service is supplied on the tape (see Figure 33 on 

page 430). Otherwise, the first word names the product to which the files apply; the second word is either 
HDR (meaning a header file) or the name of the component to which the files apply. The third word is 
always the number of files in the group. : 


Note: A product may be entirely on a single volume (prodid/); that it may cross volumes at a component 
break (prodid2); or that a single component may span multiple volumes (prodid3 comp2). In the case 
of a product (or component) crossing a volume boundary, the break will be indicated in the product 
contents directory by the inclusion of a :VOLmn record, where nn indicates the continuation volume. 


The COR Descriptor File 


| The COR descriptor file is a directory of the products and components for which service is contained on the 
( 7 corrective service tape. It shows how many files are available for each product and component and where 
| they are. The COR descriptor file is called COR ymdd, where y is the last digit of the year, m is the month 
(numbered 1 through C in hexadecimal), and dd is the day; for example, 8B05 is November 5, 1988. The 
COR descriptor file has the same format as the PUT descriptor file (see “The PUT Descriptor File” on 
page 386). Figure 13 is an example of a COR descriptor file. 


VM Corrective Service Tape 9110 1X660 PSIP SP2NP31 89/01/10 14:02:04.157208 


| 
| | VOLO1 of 01 

_ | | :VOLO1. 

( | | COR FILES 02 

Le | | 56643082 HDR 01 
| | 56643082 CP 08 
| | 56643082 CMS 09 
| | 56643082 DV Q7 
| | 56643082 GCS 03 


| Figure 13. Example of a COR Descriptor File - COR 9110 


The Product Contents Directory 


There is a product contents directory for each new format product serviced on the program update tape or 
corrective service tape. The product contents directory lists the tape files supplied for each component of 
each product, and must be repeated if the product crosses a tape boundary. The product contents directory 
can be seen as an expansion of the PUT descriptor file or COR descriptor file: the descriptor file tells you 
how many files you have and where they are; the product contents directory tells you what the files listed in 
the descriptor file are. Figure 14 on page 388 is an example of a product contents directory. 


The filename of the product contents directory is the product ID. The filetype is: 


¢ On the program update tape: $PUTzmnn, where nnnn is the PUT number 


e On the corrective service tape: $CORymdd, where y is the last digit of the year, m is the month 
(numbered 1 through C in hexadecimal), and dd is the day; for example, 8B05 is November 5, 1988. 
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prodid1 $PUTnnnn 


prodidl $CORymdd 


:VOLO1. :VOLO1 

Crs sCP 

AXLIST AXLIST 

PARTLST PARTLST 

UPDT UPDT 

TEXT TEXT 

MACAUX MACAUX 

MACUPDT MACUPDT 

SOURCE MACRO 

MACLIB 

EXEC 

RESV 

:CMS. :CMS 

AXLIST AXLIST 

PARTLST PARTLST 

UPDT UPDT oo 

TEXT TEXT Me : 

MACAUX MODULE -— 

MACRO 

MACUPDT 

SOURCE 

:VOLQ2. 

MACLIB 

EXEC 

MODULE o— 

HELP | 

TOCP 

RESV 

:DV. 

AXLIST 

PARTLST 

DVFTEXT 

DVFMODS 

RESV 

eos 

Figure 14. Examples of Product Contents Directories | “- wo 


The Memo to Users - 56643082 MEMO 


You'll receive a Memo to Users for each licensed program that needs service. The Memo contains 
instructions for servicing each program, and describes the service installation EXEC (if any) for each 
program. You should read the Memo for each licensed program before you try to apply service. 


The Memo To Users for VM/XA System Product Release 2 is called 56643082 MEMO. : 
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Update Files 


There are two types of update files: 
e Source update files for fixes to source code 
e Patch update files for fixes to object code. 


There is one update file for each part affected by an APAR. 
Source Update Files 


Source update files are named filename XnnnnnYY where 


e filename is the name of the part being serviced 
¢ mnnnn is the APAR number 
e X/YY is the value assigned to the :SLVI. tag in the product parameter file. 


Each source update file contains: 
¢ Requisite information, consisting of PREREQ, CO-REQ, and IF-REQ entries 
¢ DEPEND entries added by VMFAPPLY, identifying any PTFs for which this PTF is a requisite 
¢ Update control statements and assembler language statements defining an effective change to a module’s 


source code. (These changes are actually made as object code is created.) 


Source update files are shipped on the PUT or corrective service tape. When a source update is applied, 
VMFAPPLY changes the filemode of the update file from 1 to 5. Figure 15 is an example of a source 
update file. 


/ * PREREQ: VM33332 VM31452 
/ * CO-REQ: NONE 

./ * IF-REQ: NONE 
/ 
/ 


* DEPEND: H33330DS H34594DS 
I 09180000 $ 9182000 2000 08/16/88 20:56:22 
T™ MISFLAG2,OSTYPLD WAS THIS AN OS TYPE LOAD? @VA33331 
(WERE WE CALLED BY DMSSLN?) @VA33331 
BO LDRBO231 Don't reset EPA to new value @VA33331 
./ I 09190000 $ 9190500 500 08/16/88 20:56:22 
LDRBO231 DS OH @VA33331 


Figure 15. Example of a Source Update File - DMSLDR H33331DS 

Paich Update Files 

The customer creates patch update files for parts of the CP nucleus, CMS nucleus, and GCS nucleus serviced 
by replacement; that is, parts for which no source code is available. Patch update files contain: 


¢ Requisite information, consisting of PREREQ, CO-REQ, and optional IF-REQ entries 


e VERIFY and REPLACE statements that effectively change the object code as the nucleus is created. 
When you apply a patch update, change the filemode of the update file from 1 to 5. Figure 16 on 
page 390 is an example of a patch update file. 
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* PREREQ: NONE 

* CO-REQ: NONE 

NAME HCPAFF 

* This is a patch. It 
* will be replaced by 
* — APAR VM23877. 

VER 61C 0780 

REP 61C 0700 a 


-/ 
/ 
| 
./ 
-/ 
./ 
./ 
./ 


+ £ *  F % HF F 


Figure 16. A Sample Patch Update File 


Update Shells 


VMFREC creates update shells on the APPLY disk for parts on replacement service. Update shells use the 
same naming convention as update files. An update shell takes the place of the source update file that would 
exist if the part were on update service. Update shells contain requisite information and DEPEND entries 
(created by VMFAPPLY), but no executable code. Like source update files, update shells have the module 
name for a filename and a filetype derived from the APAR number. When the PTF associated with the 
APAR is applied, VMFAPPLY changes the filemode of the update shell from 1 to 5. Figure 17 is an 
example of an update file shell. 


./ * PREREQ: NONE 
./ * CO-REQ: NONE 
./ * IF-REQ: NONE 

./ * * THIS IS AN UPDATE FILE SHELL 


Figure 17. Example of an Update File Shell - DMSMGC H34362DS 


Text Decks 


The self-documenting text decks for CP and CMS service contain a prolog with the following information: 


1. A description of the APAR, including the APAR number, PUT level, PTF number, and content (from 
the AUX file) 


2. Prerequisites and corequisites for this service, consisting of PREREQ, CO-REQ, and IF-REQ entries and 
agreeing with the requisites in the update file and update shell 


3. A date and time stamp 


4. The macro libraries used (optional). 
The text decks also contain assembler text consisting of ESD, TXT, RLD, and END cards. 


If the filetype of an update file listed in a text deck begins with a percent sign (“%), that update 1s listed in the 
control file and not in an auxiliary control file. Figure 18 on page 391 is an example of a text deck. 
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H33398DS 203 UM90033 NLS FILE NAMING CONVENTIONS ENHANCEMENT 
- DMSMGC H33398DS C1 XA1396 09/13/88 14:34:32 
* PREREQ: NONE 
* CO-REQ: NONE 
* TF-REQ: NONE 
H34362DS 203 UM04083 GENMSG CALCULATES INDEX PAST END OF PAGE. 
. DMSMGC H34362DS A5 XA1191 11/03/88 13:03:06 
* PREREQ: NONE 
* CO-REQ: NONE 
IF-REQ: NONE 
DMSSP MACLIB = S2 XA1390 10/21/88 10:43:25 


% 


* 


. DMSMGC DMSTSP1 Al XA1191 11/03/88 13:10:22 
¢ESD ... 
CURD 5 


¢TXT ... 
¢RLD ... 
¢END ... 


Figure 18. Example of a Text Deck - DMSMGC TXT04083 


Text Shells 


VMFREC creates a text shell on the DELTA disk for each PTF listed in the prolog of a text deck for which 
neither a text deck nor a text shell is available on the PUT or on the DELTA or LOCAL minidisks. The text 
shell contains: 


1. A description of the APAR, including the APAR number, PUT level, PTF number, and content (from 
the AUX file) 


2. Prerequisites and corequisites for this service, consisting of PREREQ, CO-REQ, and IF-REQ entries and 
agreeing with the requisites in the update file and update shell 


3. A date and time stamp 

4. The macro libraries used (optional). 
The text shell does not include the executable text. VMFBLD will not accept a text shell as input. The shell 
is provided so that a search by PTF number will identify all the modules affected by the PTF. 


If the filetype of an update file listed in a text shell begins with a percent sign (%), that update is listed in the 
control file and not in an auxiliary control file. Figure 19 is an example of a text shell. 


H33398DS 203 UM90033 NLS FILE NAMING CONVENTIONS ENHANCEMENT 
2 DMSMGC H33398DS C1 XA1396 09/13/88 14:34:32 

* PREREQ: NONE 

* CO-REQ: NONE 

* TF-REQ: NONE 

H34362DS 203 UMO4083 GENMSG CALCULATES INDEX PAST END OF PAGE. 
in DMSMGC =—H34362DS A5 XA1191 11/03/88 13:03:06 

* PREREQ: NONE 

* CO-REQ: NONE 


| * TF-REQ: NONE 
I 


Figure 19. Example of a Text Shell - DMSMGC TXT04083 
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The PTF Parts List 


The filename of the PTF (program temporary fix) parts list is the PTF number and the filetype is f 
S$PTFPART. It contains a list of the parts needed to install the PTF. This list should identify the = | boned 
| appropriate text file even when the text file is not shipped on the PUT. The filemode of the PTF parts list is 
| changed to filemode 5 after the PTF 1s applied. 


The Apply List 


The apply list contains a list of the PTFs to be applied to a product. The first line in the apply list is always 
a comment identifying the product and PUT level. An asterisk (*) indicates a comment and may be used to 
exclude a PTF. Figure 20 is an example of an apply list. 


* APPLY LIST FOR PRODUCT 56643082 COR 9110 

UM03532 

UMO3605 7 
UM03603 | —_ 
UMQ3601 : Ne 
UM03586 

UM03610 

UM03590 

UM03693 

UM03728 


UM03782 
UM03790 
UM03794 


UMO3827 we 
UMQ3993 ( 
UM90033 Pat 
UM04083 
UM04165 
UM04462 


| Figure 20. Example of an Apply List - DMSXA $APPLIST 


The PUT contains an apply list for each PUT level and one for all the levels on the PUT tape. The filename 
of the apply list on the service tape is the same as the filename of the control file specified in the product 
parameter file. (If you change the filename of the control file in the PPF, the filename of the apply list is 
automatically changed too.) The filetype is: 


e For program update service: 
—  $APPxnnn for the apply list associated with a single PUT level, aes nnnn is the PUT level | | 
— $APPALL for the cumulative apply list. | 
¢ For corrective service: 


_— $APCymdd for the apply list associated with a single corrective service tape, where ymdd is the date 
(last digit of the year, month numbered in hexadecimal, day) 


— $APCALL for the cumulative apply list. (Since corrective service tapes are not cumulative, this is the 
same as the apply list associated with a single COR tape. It is included for consistency.) 


VMFREC will copy the cumulative apply list to a file whose filetype is SAPPLIST, and append any 
cumulative apply list it finds on the intermediate alternate disk(s). fn $APPLIST is the apply list used by the 
VMEFAPPLY EXEC. If you want VMFAPPLY to use a different apply list, you must copy it with a filetype 
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al 


of $APPLIST. (Use the REPLACE option.) Copy it instead of renaming it so that you are sure to keep the 
apply list you used. 


The Exclude List 


The exclude list contains a list of the PTFs that are not to be applied to a product, even though they are 
listed in the apply list. Entries must be in the same order as in the apply list. The first line in the exclude list 
is always a comment identifying the product and PUT level. Figure 21 is an example of an exclude list. 


* EXCLUDE LIST FOR PRODUCT 56643082 COR 9110 


UM0Q3601 
UM90033 


Figure 21. Example of an Exclude List - DMSXA $EXCLIST 


The PUT contains an exclude list for each PUT level and one for all the levels on the PUT tape. The 
filename of the exclude list on the service tape is the same as the filename of the control file and apply list. 
The filetype is: 


¢ For program update service: 
— $EXPnnnn for the exclude list associated with a single PUT level, where nnnn is the PUT level 
— $EXPALL for the cumulative exclude list. 

e For corrective service: 


— $EXCymdd for the exclude list associated with a single corrective service tape, where ymdd 1s the date 
(last digit of the year, month numbered in hexadecimal, day) 


— $EXCALL for the cumulative exclude list. (Since corrective service tapes are not cumulative, this is 
the same as the exclude list associated with a single COR tape. It is included for consistency.) 


VMFREC will copy the cumulative exclude list to a file whose filetype is SEXCLIST, and append any 
cumulative exclude list it finds on the intermediate alternate disk(s). fm $SEXCLIST 1s the exclude list used by 
the VMFAPPLY EXEC. If you want VMFAPPLY to use a different exclude list, you must copy it with a 
filetype of $EXCLIST. (Use the REPLACE option.) Copy it instead of renaming it so that you are sure to 
keep the exclude list you used. 


Note: If two PTFs are in the same text deck, you cannot exclude the first unless you also exclude the second, 
even if you list the first one on the exclude list. This restriction applies because the first PTF is 
considered to be a prereqisite for the second PTF. 


If you list the first PTF in the exclude list, but not the second, and if the second PTF appears in the 
apply list, both PTFs are applied. You receive an error message indicating that a PTF you wanted to 
exclude has been applied. 


The Exception Log 


The exception log is called SVMFXXX S$ERRLOG, where XXX can be: 


e REC for the receive exception log created by the VMFREC EXEC 
e APP for the apply exception log created by the VMFAPPLY EXEC 
¢ BLD for the build exception log created by the VMFBLD EXEC. 


The exception log contains any error or informational messages issued by its corresponding exec and is 
written to the A-disk. If the exception log already exists when the exec is invoked, a date and time stamp 1s 
inserted to separate the earlier log entries from the new entries. You should browse the exception log with 
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| the VMFVIEW EXEC after VMFREC, VMFAPPLY, or VMFBLD finishes processing. Table 11 on 
page 394 shows the different types of messages that may appear in an exception log. 


Note: All messages except status messages must be investigated. A warning message does not necessarily 
mean that anything is wrong, but you cannot be sure until you check it out. 


Exception logs are cumulative. The most recent entries are at the top. 


| The Receive Exception Log 


KREKKEKRKEKKKKKKRERKER EKER REE EERE ERE RR EEKRERE RE RRR RERERERKEKERKERKEKRER 


a as RECEIVE - 04/13/89 - 13:29:10 - run wees 


HKHKKKKKKKKK KKK KEKE KKK ERK EERE KKK ERR ER RRR ERE ERE EERE KRERER 


Tere Product: 56643082 Component: CMS aa 


a ey ee oe 


BRKEKKEREKRRKEKEREKRRERREEKREREREKEEREKEEEERERERERERERRRERRERRERRERRRRRRREE 


| Figure 22 (Part 1 of 2). Example of a Receive Exception Log - S8VMFREC $ERRLOG 
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:DMSREC1852I This is VOLO1 of 01, level 9110 COR tape. 

:DMSREC1806I The current SERVICE DISKMAP file contains 

: the map of the mounted tape. 

:DMSREC1804I Receiving service for component CMS of product 56643082 
sDMSREC1940I Merge processing is not required for component CMS. 
:DMSREC1851I Processing AXLIST with the part handler VMFRCAXL EXEC. 
:DMSREC1851I Processing PARTLST with the part handler VMFRCCOM EXEC. 
:DMSREC1851I Processing UPDT with the part handler VMFRCUPD EXEC. 
:DMSREC1851I Processing TEXT with the part handler VMFRCTXT EXEC. 
:DMSREC1851I Processing MACAUX with the part handler VMFRCAUX EXEC. 
:DMSREC1851I Processing MACUPDT with the part handler VMFRCUPD EXEC. 
:DMSREC1851I Processing EXEC with the part handler VMFRCCOM EXEC. 
:DMSREC1851I Processing MODULE with the part handler VMFRCCOM EXEC. 
:DMSREC1851I Processing HELP with the part handler VMFRCCOM EXEC. 
:DMSREC1851I Processing HELP with the part handler VMFRCUPP EXEC. 
:DMSREC1850I The processing for RESV by the VMFRCCOM EXEC was bypassed. 


KRKKEKEKKEKKERKEKKEKKRRKEKEKRREKRERKKEKREKEKEREKKRKEKKRERERRREEEEKEKKKEKRERKREKER 


Sen RECEIVE - 04/13/89 - 13:28:58 - run abeclal 


KEKKEKKKEKEKRRKEKERERERKERERERREREERERERKERREKREKREEEEKKEREKEEKREKKKKKKKE 


KEKEKEKEKKKEREKEKEEKEKRKRRKRERERERRKRKRERREKKEKKERKERKERAEKERAEKEKAAKKKRKKER 


ST:DMSREC1852I This is VOLO1 of 01, level 9110 COR tape. 


| Figure 22 (Part 2 of 2). Example of a Receive Exception Log - SVMFREC $ERRLOG 


The Apply Exception Log 


KEKKEKKEKRKEKRKKEKREKREEEREERREREREKRKEKERRERERRKEEKEKREKEEREREEKREKKKRKEEREKEKEKKREEKRE 


ei catui APPLY - 04/13/89 - 13:42:26 - run igang 


KEKKEREKKEKREKKEEKREKERRERRERREREKEERRKEKEREKRREREKEREEREKRRERKREKKRERRKEKEEKEKEE 


pasa Product: 56643082 Component: CMS ees 
KEKKEKKKEREKERKERERKERERKEKEEE REE RRR RKREKKKRKEKKKRERKRERERERERERKERKEEKRERERER 

MNT191 191 R/W 

MNT395 395 R/W 

MNT691 691 R/O 

MNT391 391 R/0 

MNT692 692 R/O 

MNT392 392 R/O 

MNT593 593 R/O 

MNT293 293 R/O 

MNT193 193 R/O 

MNT393 393 R/O 


> 


B 
E 
F 
G 
H 
I 
J 
K 
L 


| Figure 23 (Part 1 of 2). Example of an Apply Exception Log - $3VMFAPP $ERRLOG 
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MNTI90 199 S R/O 

MNTI9E 19E Y/S R/O 

ST:DMSAPP18531 Processing PTF UMQ3532 

ST:DMSAPP1851I Processing DMSLDR TXTQ3532 with the part handler VMFAPTXT EXEC. 


WN: DMSWTL1885W KKEKRKKEKEKEREREREREERERERERERRREKRERERERRERERRRERERERKEKE 


WN: *** DMSLDR AUXLCL listed in DMSXA CNTRL AK 
WN: *** represents service at a higher level than KEK 
WN: *** DMSLDR AUXCOR . The higher level service *** 
WN: *** may need to be reworked or removed. Ke 
WN: en a Sa SD er ER at em ESE Yad Oa TROON RE kK 
WN: *** PMSLDR AUXLCL aK 
WN: ee pee eseumeasess caste ceSese seems ses eK 
WN: *** LOOODO3LC LCL LCLO0003 eK 
WN: *** LOOOOZLC LCL LCLOO0002 kK 
WN: **k* LOOOOILC LCL LCLOO001 #wK 
WN: KREREKKKRKEKKKERRRKERERREKRRKRERRERERRRERRRRKRERERREERREKERR:G 
BD:DMSAPX1858I CMSLOAD build list contains files that 

BD: have been serviced. Aa 


ST:DMSAPP1851I Processing DMSLDR H33150DS with the part handler VMFAPCOM EXEC. \ 
ST:DMSAPP1853I Processing PTF UM03605 “i 
ST:DMSAPP1851I Processing DMSLDR TXT0Q3605 with the part handler VMFAPTXT EXEC. 

ST:DMSAPP1851I Processing DMSLDR H33331DS with the part handler VMFAPCOM EXEC. 

ST:DMSAPP1853I Processing PTF UM03603 

ST:DMSAPP1851I Processing DMSLDR TXTQ3603 with the part handler VMFAPTXT EXEC. 

ST:DMSAPP1851I Processing DMSLDR H33330DS with the part handler VMFAPCOM EXEC. 

ST:DMSAPP1856I PTF UMO3601 is in the DMSXA $EXCLIST 


nme re te en en ee rte meee tenes eee | an eemremete tiene | eet eee eminent 


ST: exclude list for product ID 56643082, and 
ST: will not be applied. je 
: ( 
| :DMSAPP1823W The UMO3844 $PTFPART PTF parts list file was not found. ee 
| : A PTF might be missing for product ID 56643082. 
| sDMSAPP1823W The UM03894 $PTFPART PTF parts list file was not found. 
| : A PTF might be missing for product ID 56643082. 
| Figure 23 (Part 2 of 2). Example of an Apply Exception Log - S3VMFAPP $ERRLOG 
The Build Exception Log 
| of 
KRKKKKK KEKE RIKER RR EKER ERR RRR RRR ERE KEE EKER REE RRR RRR RRERRRERREREE oY 


weer BUILD = 04/13/89 - 14:30:09 - run **RRE 


WERE KKEKREERERRRREREREKERKRR REE RRRREREKEEE REE EKRRERRERERERERERRERERER 


aa Product: 56643082 Component: CMS REBES 


KEKKEKEKKKKREKRERKKRRRKEERREERKRERER EERE RERRKEREKRRERERERERERRREEREREKRREREE 


ST:DMSBLD1851I Processing CMSLOAD with the part handler VMFBDNUC EXEC. 


RQ:DMSBNC1857I APAR VM30394 is a required requisite, but 
RQ: part DMSSCRCB T30394DS on disk 293 has not 
RQ: been applied by VMFAPPLY and the update file 
RQ: is not fmd. 


| Figure 24. Example of a Build Exception Log - SVMFBLD $ERRLOG 
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The Receive History Log 


The receive history log has a filename of SVMFREC and a filetype of SHISTORY. The receive history log 
contains a list of all CMS files received from the PUT when VMFPLC2 is invoked by VMFREC for any 
component of VM/XA SP, and shows the date and time when each file is received. 


Note: Files loaded from tape using any of the INFO options of VMFREC EXEC do not appear in the 
receive history log. Therefore, the various tape documents, the service disk map, and the service 
EXECs will not appear in the receive history log. 


The receive history log is cumulative. It differs from the exception logs in that the most recent entries are at 
the bottom. 


KRREKKKKKEKKEEKREKEEKREKREKRREERKRKRKEEEKRREREREEKRREEKRKEKKERKKKKEKE 


Receiving: 56643082 - CMS 13 Apr 1989 13:29:31 
KKKKIKKKKKEKEKKEKERKKRKEREREEKKKREKRERRKEREERERERERKKERERKKREERE 
LOADING 

DMSXA  $APCALL_ B1 

DMSXA — $APC9110 B1 

DMSXA  $EXCALL_ BL 

DMSXA — $EXC9110 B1 

END-OF-FILE OR END-OF-TAPE 

LOADING 

UMO3532 $PTFPART Bl 


» 
KRKKEKKKEKRERKEEKREKKERERERERKEREREEREEREERERERERERERRREERERERKE 


End Receive for: 56643082 - CMS 13 Apr 1989 13:31:00 


KRREKKEKRERERERERERERRERRKEREREREKRKREKRKEKREEEKRRRREREKKEKKRERKRKEKE 


Figure 25. Example of a VMFREC History File - $VMFREC $HISTORY 


The Load List 


The load list is an ordered listing of the CP, CMS, or GCS modules. The ordering (top to bottom) 
determines which modules come first on the system residence device and which modules come into storage 
upon an initial program load. 


The CP Load List 

For the CP load list, the order 1s determined by the HCPMDLAT MACRO, which is invoked by the 
HCPLDL ASSEMBLE module. The load list is created when HCPLDL is assembled. CPLOAD EXEC is 
shipped on the PUT service tape, but is not shipped on the Corrective Service tape. Therefore UTILITY 
must be used to generate the CPLOAD EXEC only if corrective service is applied or if local modifications 
are made. 


The file created by assembling HCPLDL is called HCPLDL TEXT or HCPLDL TXTxxxxx. If it is called 
HCPLDL TXTnannn, you must rename it HCPLDL TEXT. You must then use the UTILITY EXEC to 
convert HCPLDL TEXT to CPLOAD EXEC. 
The modules fall into these general categories: 

e Resident modules. These modules are nonpageable. 


e Pageable modules loaded at initialization. These modules may not be paged until system initialization 
has finished. Thereafter, the modules can be paged out. 
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¢ Other pageable modules. These modules, along with the modules that are resident only during 
initialization, comprise the part of the system that CP pages in and out of real storage. 


The CP load list must have fixed-length 80-byte records. 
Do not change the CP load list unless it is absolutely necessary. 


The CMS Load List 


The CMS load list is called CMSLOAD EXEC. Do not change anything in the CMS load list except the 
SLC (Set Location Counter) cards, which point to files that determine where the modules in the CMS 
resident nucleus are loaded. 


The GCS Load List 


The GCS load list is called GCSLOAD EXEC. Do not change anything in the GCS load list. 


The Temporary Load List 


The temporary load list is a file generated by VMFBLD. It includes all of the text decks in the original load 
list (CPLOAD EXEC for CP, CMSLOAD EXEC for CMS, GCSLOAD EXEC for GCS, etc.) as well as the 
filetype of the “latest” version of the text deck (latest being determined by the CNTRL and AUX file 
structure). HCPLDR MODULE generates the CP, CMS, and GCS nuclei using the temporary load list for 
each component. 


FT 


&TRACE OFF 

&1 &2 &3 HCPLDR LOADER 
&1 &2 &3 HCPSYS TXT12345 
&1 &2 &3 HCPRIO TXT22333 
&1 &2 &3 HCPDDI TXT98765 


&1 &2 &3 HCPMM3 TXT22333 


Figure 26. Example of a Temporary Load List - $$$5TLL$ EXEC 


The Load Map 


The load map has the same filename as the control file and a filetype of LOADMAP. It contains the map of 
CSECT external symbol resolution and service level information from the text decks, which are 
self-documenting. It is written to the A-disk if you specify the DISK option for the VMFBLD EXEC. 
Otherwise, it is spooled to the printer. 


If the filetype of an update file listed in the load map begins with a percent sign (%), that update is listed in 
the control file and not in an auxiliary control file. 


Restart Indicator Files 


The VMFREC EXEC stores one or two restart indicator files on the first target disk in the string used during 
the receive process. Do not erase the restart indicator files. If you need to restart VMFREC, they determine 
how VMFREC will proceed. : 


398 Installation and Service 
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The restart indicator files are called: 
e For program update service: 


prodid S$MRPnnnn 
prodid $PUTnnnn 


where: 


prodid 
is the identifier of the product for which service is being received, for example, 56643082. 


nnnn 
is the PUT level. 


e For corrective service: 


prodid $MRCymdd 
prodid $CORymdd 


where: 


prodid 
is the identifier of the product for which service is being received, for example, 56643082. 


ymdd 
is the date (last digit of year, month numbered in hexadecimal, day). 


If the $MRxxxxx file is present, the files for PUT level nnnn or corrective service dated ymdd have been 
received and VMFREC has successfully completed. The MERGE disks will be merged from alternate to 
current when VMFREC is rerun for the same product or component. The components for which service 
have been received are listed in the $MRxxxxx file. 


prodid $PUTnnnn or prodid $CORymdd contains the first record of the PUT or COR descriptor file, plus the 
date when VMFREC was run and, for corrective service, the time. If this file is present for a tape you want 
to receive, it indicates that VMFREC has already been run for this tape. 


The $LEVEL MAP File 


The $LEVEL MAP file is the inventory of service tool parts that may be in files 1 and 2 of the service tape. 
It lists all the parts of a tested level of the service EXECs that exist in file 1 of the tape as well as the total set 
of $PPF files that can possibly be found in file 2 of the tape. The format is the following: 


e Line 1: The fifth word is the level of the service EXECs in file 1. (The asterisk at the start of the line 
counts as one word.) 


Only the fifth word is significant. 
e Line 2: Comment heading of file types for XA/SP2 and 370/SP. 
The columns are: 


— file name 

— real file type 

— PTF-numbered file type for XA/SP2 
— PTF-numbered file type for 370/SP. 


The service EXEC parts distributed in file 1 are XA/SP2 parts which for a given PTF-numbered level are 
functionally equivalent to the 370/SP 6 PTF-numbered parts listed in column 4. 


e Lines 3-n: The list of executable service parts. 
e Line n+1: End of executable parts indicator. 


e Lines n+2-n: List of $PPF files that exist. 


Chapter 8. Files Used in Service 399 


This list contains the names of all existing product $PPF files. The service tape contains some subset of 
these $PPF files depending upon the product set it contains. If an ordered product has a $PPF associated 
with it, that $PPF will be on the tape. 


* SES PUT LEVEL 8901 

XA/SP2 370/SP6 
VMFREC EXEC £XC12345 EXC12346 
VMFRCTXT EXEC  EXC12345 EXC12346 


$VMFMSG$ EXEC  EXC23123 EXC23124 
VMFLDS MODULE M0D12345 M0D12346 
* PPFs in the second tape file 
56643082 $PPF $PF12345 


5664167E $PPF $PF12346 


Figure 27. Example of a $LEVEL MAP file 


The $LEVEL EXEC File 


The $LEVEL EXEC file is the inventory of service EXEC parts that are installed on your system. It has the 
same format as the $LEVEL MAP file but its content is slightly different. It reflects the union of the service 


EXEC parts and $PPF files that the customer has actually received using either VMFREC INFO or 
VMFREC prodid. 


When receiving service EXEC parts using VMFREC prodid, you must manually update the $LEVEL EXEC 
file to reflect the installed level of the service EXECs. To do this, update the level word in line 1 with a 
suffix (for example 8901A) and update the body of $LEVEL EXEC to reflect the new PTF-numbered file 
type for the part. If you run “VMFREC INFO (EXECS”, it creates or upaares the $LEVEL EXEC file to 
reflect the service EXEC parts loaded from the tape. 


The $LEVEL $TAPE File 


This file is a copy of the tape map for the first two files (the header files) of the service tape. It may be used 
to check the contents of the tape against the $LEVEL MAP tape inventory file if discrepancies are reported. 
Figure 28 on page 401 shows a sample $LEVEL $TAPE file. | 
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SCANNING 
COR 

COR 
$$LDR$$ 
$VMFCHK$ 
$VMFMSG$ 
$VMFPAT$ 
VMFAPCOM 
VMFAPNLS 
VMFAPPLY 
VMFAPTXT 
VMFASM 
VMFBDCPY 
VMFBDNUC 
VMFBLD 
VMFHASM 
VMFLDS 
VMFOVER 
VMFRCAXL 
VMFRCCOM 
VMFRCTXT 
VMFRCUPD 
VMFRCUPP 
VMFREC 
VMFSETUP 
$LEVEL 


8B18 Al 
DOCUMENT Al 
XED12348 Al 
XED12347 Al 
EXC12345 Al 
EXC12346 Al 
EXC12345 Al 
EXC12349 Al 
EXC12348 Al 
EXC12347 Al 
EXC12346 Al 
EXC12345 Al 
EXC12349 Al 
EXC12348 Al 
EXC12347 Al 
MOD12346 Al 
EXC12349 Al 
EXC12346 Al 
EXC12345 Al 
EXC12349 Al 
EXC12348 Al 
EXC12347 Al 
EXC12346 Al 
EXC12345 Al 
MAP Al 


END-OF-FILE OR END-OF-TAPE 


56643082 
56643082 
56643082 


$PF12345 Al 
MEMO Al 
0200241 Al 


END-OF-FILE OR END-OF-TAPE 


| Figure 28. Example of a $LEVEL $TAPE File 


The Product Parameter File 


| You must have a product parameter file in order to update products supported by the new service EXECs, 
( including VM/XA System Product. The filename of the product parameter file is the product ID—for 
7 example, 56643082—and the filetype is $PPF. 


The product parameter file consists of a product area, one or more component areas, and one or more 
override areas. 


¢ The product area (introduced by the :COMPLST. tag) lists the components of the product. 
e Each component area (introduced by a :compname. tag) has three sections: 


— The first section (introduced by the :CNTRLOP. tag) contains control options such as the control file 
name, the system level and version, and the national language. 


— The second section (introduced by the :MDA. tag) contains minidisk assignments: 


— The TASK disks, where you can isolate the latest level of service EXECs 

— The LOCAL disks, where you keep local update files 

— The APPLY disk, where the auxiliary control structure will be built 

-—- The DELTA disks, where you will load the update files from the program update tape (PUT) 
— The BASE disks, holding the component’s source and object code 

— The BUILD disks, on which you will build your new system 

— The system’s minidisks. 
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— The third section (introduced by the :PRTFNC. tag) lists the EXECs needed to service each part of 
the component. There are three functional sections: 


— Receive (introduced by the :RECSER. tag) 
— Apply (introduced by the :APP. tag) 
— Build (introduced by the :BLD. tag). 


e Each override area (introduced by an :overname. tag) contains changes that can be made to the 
corresponding component area when the user wishes. The override area permits you to build several 
different systems with a single product parameter file. | 


A Sample Product Parameter File 


The listing below is a sample product parameter file. The tags are explained in “The Tags in the Product 
Parameter File” on page 412. 


Seeococcssscss sss = 

‘ Product Parameter File for VM/XA SP Release 2 

See ee ee eee = se : 

. oc’ 

* The following APAR's have been applied to this file: | So 

* 

* VM32064 - 05/24/88 - New Support for Service Enhancements 2.1 

* VM32436 - 08/01/88 - New Function for Service Enhancements 2.1 

* VM35065 - 01/04/89 - Change to MACUPDT VMFRCUPD in RECSER section | 

* New load lists in CP/CMS in BLD sections | 

* VM35315 - 01/06/89 - PE VM35065 Change EXECUPD VMFRCCOM to | 

- EXECUPD VMFRCUPD in RECSER section of DV and GCS | 

* M35316 - 91/06/89 - Remove 19F from SYSTEM disk string | 

* VM35405 - 01/09/89 - Remove DELTA2 string from GCS section in $PPF oo” 

* VM36183 - 02/28/89 - Add CPYSYSDV to DV BLD section in $PPF. Requires Wa 

= : Dump View CO-REQ apar VM36326. 

* VM36911 - 04/20/89 - Add HELP to DVF section of PPF. Prereqs DVF 

- PTF which shipped this service HELP (VM36585) 

* VM37518 - 06/23/89 - New AUX file part handlers added. New CKUPD tag 

* added. Reformatted for readability. COR 

* overrides moved to after base sections. 

* 

Serco sees = 

* NOTE: All tags must be in upper case. —_— 

Rea Sane Sa ee ee ae a ee ee ee Se eS SS ee | 
ed | 

* Start of Product Header - List of Components in VM/XA SP Release 2 

*Serscccscss sss sss es = 

: COMPLST. cP CMS) «=O 

:OVERLSTP. | 

sOVERLST. | CORCP CORCMS CORDV CORGCS 

Sass SSS see Se es 

* End of Product Header 

SS ee SS a ee Se ee ee = a 

Scoot see 

:CP * Start of Parameters for CP 

Seeocmscscscscs sos sss eee 

:CNTRLOP. * Section one - Control Options 

-s * DO NOT DELETE THESE CONTROL TAGS 

* TAG VALUE(S) * DESCRIPTION 

** 

:CNTRL. HCPXA * Control File name 
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He 


:UPDTID. 


:SLVI. 
¢NLS. 


sUSEREXIT. 


kk 


tte nt 


AUXXA 
H/HP H/PP 
AMENG 
VMFUECP 


DELTA1 APPLY LOCAL 


4  F Fe F F F F € X F 


Update level identifier for building AUX 
System level and version indicators 
System Language 

User exit EXEC. Called before initial 
accesses and after final access retore. 
2 paramters passed will indicate calling 
EXEC and SET-UP or CLEAN-UP. 


Disk strings to be merged at Receive 
Erase lower level TEXT decks at Receive 
Check for full text at Apply 

Check update fm regardless of $PTFPART fm 
Check composite AUX at Build 

Check Requisites at Build 


AF CY AS IE CN OD ON SS SS NS SC I OS SS TT A A AS Ne ON ER SS A OE EN SN EE SS A AS CS NN ES ST A RD NS CS A SS eS T_T SAS ee Sa 


** 


* STRNGNAM 


**k 


*TASK 
LOCAL1 
*LOCALn 
APPLY 
DELTA] 
*DELTAn 
BASE1 
BASE2 
*BASEn 
*BUILD1 
BUILD2 
BUILD3 
BUILD4 
*BUILDn 
SYSTEM 


** 


MINIDISKS 


191 
295 591 2 


492 192 
594 294 


194 
394 


423 
49D 
49C 
490 


191 395 691 391 59 


91 


Section two - Mini-Disk Assignments 


* STRING NAMES MUST START IN COLUMN 1 


+  & £ OO F FH FEF HF HE HH FH HE HF HF HF HH HK 


DESCRIPTION 


Build disks accessed before rest of dbase 
Disks for corrective and local service 
You may define additional LOCAL disks 
Control structure built by service execs 
CP service from TAPE 

You may define additional DELTA disks 

CP text, loadlist,control file,maclibs 

CP source,macro defs,and copy files 

You may define additional BASE disks 

New SYSRES for CP Nucleus Build 

New CMS system disk for AMENG HELP files 
New CMS system disk for UCENG HELP files 
New CMS system disk for nucleus etc. 

You may define additional BUILD disks 
293 193 

Disks reqd for your system environment. 
CMS database needed for MACLIBs. If 
latest MACLIBs are on a build disk, only 
that disk must appear here. 


sRECSER. 


** 


* TAPEFILE 


***k 


AXLIST 
PARTLST 


UPDT 
TEXT 


*x*k 


*k* 


MACAUX 
MACUPDT 
SOURCE 
MACLIB 


EXEC 


** 


HELP 


** 


EXEC 


VMFRCAXL 
VMFRCCOM 
VMFRCUPD 
VMFRCTXT 


VMFRCAUX 
VMFRCUPD 
VMFRCCOM 
VMFRCCOM 
VMFRCCOM 


VMFRCCOM 


TARGET 


DELTA1 
DELTA1 
DELTA] 
DELTAI 


DELTAI 
DELTAIL 
DELTA1 
DELTA1 
DELTA1 


BUILD2 


* 


+ + + F FF F F F F F F HF 


Receive (Service) 
DESCRIPTION 


Apply and Exclude lists 

PTF Parts Lists 

Update files for CP ASSEMBLE source 

Text replacement modules for CP 

Text shells created on target disk 
Update shells created on APPLY disk 

AUX files for updates to non-ASSEM parts 
Update files for non-ASSEMBLE parts 

New Source (assemble,macro,copy,$exec...) 
Maclibs are not replaced on the base 
Replacement parts and regenerated 

parts other than maclibs, text, modules 
AMENG HELP files go directly to the 
AMENG help Build disk 
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BUILD3 


DELTA1 
BUILD4 
DELTA1 


UCENG HELP files go directly to the 


UCENG help Build disk 


Reserved parts 
CP modules targeted for system disk 
PTF numbered parts other than TXT 


AUD ARNE SANE NERD SENS Manes SUID FAAAED SERS) LLL SRA SHY LY SEL GeTEEN SRE SOMMER ROGNS ONS SOPONE SRANERS GRR MRED SEDGE MADEN GEORG MODES SSE! SG MEE US OIA SAAR SNELL ST TER NS SL SA SENET AD MA SOND NE SONS Geek SLANE meee SOEAN AERAD SILKE ENING SEAN SOS GOD Met SOT RANE WASEDS UALS TUN CSUR WORE GNSS MESS SETS WONT URE Ok stein COTE 


RENAME 


TEXT 


TXTAMENG 
TXTKANJI 
TXTUCENG 
TXTPORTG 
TXTFRANC 
TXTGER 


AUXXA 


Apply Function 
DESCRIPTION 


Create AUX and rename appropriate update 
files to fm5 for names in loadlist. 
Other TXT parts renamed to TEXT 

For American English NLS support 

For KANJI NLS support 

For Uppercase English NLS support 
For Brazilian Portuguese NLS support 
For French NLS support 

For German NLS support 

For MACRO and EXEC AUX files 

For MACRO and EXEC AUX files 


ALL PARTS ARE LISTED BY FILETYPE 
If a part type is not listed 
VMFAPCOM is called by default 


ew emma oY Ceri Se eae maine HAL SET See) eT ATR CEN GNA GaN STEN PRES SRE eT RIOTS STO RT NS ATT CRE SEE MERE SE REE FOR ETS SES SOE (ONE FERRE Hae SS CRETE eet SR ND SE CR SEES Se ETT neon Sei Se Seer Sannare vie serine ea Heth EE RUE NEES! hee TTS PRE RY ini Sew Ore ener SA Wie 


TARGET 


*BUILDI 


BUILD4 


DELTAI 


DELTA1 


* 


+ + FF F F 


+ + 


+ + & F 


Build Function 
DESCRIPTION 


Create CP nucleus based on loadlist 
Target disk symbol agrees with 

disk address in HCPSYS ASSEMBLE 

on the SYSRES macro. Defaults to 
what is in HCPSYS ASSEMBLE if no 
target disk is specified. 


Copy TEXT decks that do not become 
part of a MODULE to the system disk 


Copy TEXT decks used by UTILITY and 
listed in the load list, CPLOAD EXEC, 
to the DELTA disk. VMFAPPLY only 
copies the ones not listed in the 
load list. 


Copy TEXT decks used by UTILITY which 
are not listed in the load list, 
CPLOAD EXEC. This list would be used 
if you have local modifications and 
you choose not to run VMFAPPLY. Al] 
TEXT decks for which you have received 
service and/or have local mods would 
be copied as a result. You need to remove 
the asterisk before CPYUTLCP before 
running VMFBLD. 

Use UTILITY to build CP Utilities 


cS gS ED STAN SE MERE RE A IE NT NE NL LE SN SD NS NE NT OR CE RS TS EE CD SS TE SN SN CEES NS NE NR A A Se SE NS RN ee CN A ON NE SN SN EA NS SS NN EE A SS SY A SE A SL SE RN NN SRR RE OO RT 


HELP  VMFRCUPP 
** 
RESV *VMFRCCOM 
CPMOD VMFRCCOM 
PTFS  VMFRCCOM 
:APP. 
*k* 
* PARTTYPE EXEC 
** 
TXT* — VMFAPTXT 
k* 
** 
TAM*  VMFAPNLS 
TKA*  VMFAPNLS 
TUC*  VMFAPNLS 
TPO*  VMFAPNLS 
TFR*  VMFAPNLS 
TGR*  VMFAPNLS 
AUXXA  VMFAPAUX 
AXA*  VMFAPAUX 
EXEC VMFAPCOM 
MACRO VMFAPCOM 
* VMFAPCOM 
* VMFAPCOM 
* VMFAPCOM 
:BLD. 
* BUILDLST EXEC 
** 
CPLOAD  VMFBDNUC 
Kk 
** 
kk 
kk 
** 
**k 
CPYSYSCP VMFBDCPY 
*k* 
*K* 
CPYBTHCP VMFBDCPY 
kk 
kk 
kk 
K* 
*k* 
* CPYUTLCP VMFBDCPY 
k* ; 
** 
k* 
** 
Kk 
K* 
*k* 
k* 
**K 
** 
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a 


a 
a 


:CORCP. CP . 
Seo eee eee 
:UPDTID. AUXCOR x 
:MERGE. LOCAL1 m 
:MDA. UPDATE 

LOCAL1 295 591 * 


APPLY 295 591 291 492 192 * 
DELTA1 295 591 291 594 294 * 


:CMS. ~ 
* a 
:CNTRLOP. * 
*x* 

* TAG VALUE (S) ss 
ek 

:CNTRL. DMSXA * 
:UPDTID. | AUXXA = 
:SLVI. H/DS 1/DS : 
:NLS. AMENG = 
sUSEREXIT. VMFUECMS x 
*x* * 
kK* * 
kk * 
>MERGE. DELTA1 APPLY LOCAL1 
**k * 
:LTO. NO * 
sCKTXT. YES % 
:CKUPD. NO = 
:CKAUX. YES « 
:CKREQ. YES = 
i es a a ah ace sec eed 


:MDA. - 
Kk 

* STRNGNAM MINIDISKS = 
kk 

*TASK 191 - 
LOCAL1 395 691 391 % 
*LOCALNn - 
APPLY 692 392 * 
DELTA1 593 293 x 
*DELTAn “ 
BASE1 193 * 
BASE2 393 ¥ 
*BASEn * 
BUILD1 490 % 
BUILD2 49D * 
BUILD3 501 2 
BUILD4 49C = 
*BUILDn bf 
SYSTEM 191 295 591 291 594 
*k* * 


** 


End of Parameters for CP 


 conmshrasenfanaciambemmnahannetanvehercespcaelmumedammabercahenamabesund uneahaaredmeneersentmmad past amabamabasmatamnecbenepheneel-rastamackneakereh-aackaseatavedaredh-edunend-venahenakeendemehamnd 
CUS Gees Tatas SEE DSS SURES ONES cae Sane LENS OEE SONNE ESN MOPED AGT SS aS SED ET SES Ee GEES RA ARES RS GELNTD SNS SL SAND SONS PEN GUNA ND SND MAUD GRANDS GS WON sore RE 


Le coa}amnbenrenbereadenrertoanednsurleunabamaahaswad ceedatnalnand-ameknonshewtoehemend mean taamnehenand asssteaaedpamnabasnnebatendamart-sonabaensbensetenasteamnd-nsedememdnaact-oned-atach ependamntenadmndemmnd 
AS A RS SRE SY So et Le SET SR Di Cee) SES EES EN A EEE ES SONY ST inten GAA EN GOST GP GE SEE GET GEES EES CEE SA OP CoE SE ae CS GN GES AS 


COR service applied at AUXCOR level 
Merge only LOCAL1 not APPLY and DELTA] 


Merge doesn't go to SUP reach-ahead disk 
LOCAL1 disks added to APPLY string 
LOCAL1 disks added to DELTA] string 


EE AE AS TE NS AS NS SE A SS ES SS SN NE EE SE SO SN SS EE SD ONS ER EE SS EN SNS SEO SS TE SW OS NE SE i SN 
eS TF SS AS ST A SN AN ANS ST SA A SS SS AD NN VD SETS SANS SINT RD SS SE SEES SEA A GS OY AL SAEED SANYO ALI NEE SD wD 


FP cuakvaaebcedh cae ennistanahasuslcedusnedh amadsmahenealkaneetnmabiaehasad nedkneedeanshunastaracdeend-eatunadsermtenndaumdammabensstnngdlesedamakasaidsesrdkerrsieassdeaadcmieratteaabacn’ 
Sr a ae nS ET TS eT SED ome TERE Owe! Mies Man SERRE COE Orie SRE BOS EN OP NS SE CES AS A ke RS SAE ea RED TT SERED A CONN EEE POS Wee GRD BEET OD 


Section one - Control Options 


* DO NOT DELETE THESE CONTROL TAGS 


DESCRIPTION 


Control File name 

Update level identifier for building AUX 
System level and version indicators 
System Language 

User exit EXEC. Called before initial 
accesses and after final access retore. 
2 paramters passed will indicate calling 
EXEC and SET-UP or CLEAN-UP. 


Disk strings to be merged at Receive 
Erase lower level TEXT decks at Receive 
Check for full text at Apply 

Check update fm regardless of $PTFPART fm 
Check composite AUX at Build 

Check Requisites at Build 


Section two - Mini-Disk Assignments 


* STRING NAMES MUST START IN COLUMN 1 


DESCRIPTION 


Build disks accessed before rest of dbase 
Disks for corrective and local service 
You may define additional LOCAL disks 
Control structure built by service execs 
CMS service from TAPE 

You may define additional DELTA disks 
CMS text,loadlist,control file,maclibs 
CMS source and macro definitions 

You may define additional BASE disks 

New CMS system disk for nucleus etc. 

New CMS system disk for AMENG HELP files 
New CMS system disk for EREP files 

New CMS system disk for UCENG HELP files 
You may define additional BUILD disks 
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Disks reqd for your system environment. 


* CP database needed for MACLIBs. If 
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kk * latest MACLIBs are on a build disk, only 


ae * that disk must appear here. 

Seer ee eee 
:PRTFNC. * Section three - Part type/Function List 
sRECSER. * Receive (Service) 


** 


* TAPEFILE EXEC 


** 


AXLIST 


PARTLST 


UPDT 
TEXT 


** 
kk 


MACAUX 


MACUPDT 


SOURCE 
MACLIB 
EXEC 


** 


MODULE 


Kk 


eS RE TT CET CANE AE ROE LE SL SS LT SSNS STEN OTE SEN CONE FTO NY WR UI HOUNE SUE SERA LOT SAUNT! NNER GUA SERA HENNY MA CASS SOT GEN CEN CHA HOES NITE CRE GAD WANE NEUEN SL OTE SUAS WOR GERM cate Ne SOE TURD Rested CeNNNL COE MLEED SUNOS GERMIY COLES CUNY DERE SYTTN GLE GRAS SONNE WOU GR SEL OID GAAS OUR COUN COT 


** 


VMFRCAXL 
VMFRCCOM 
VMFRCUPD 
VMFRCTXT 


VMFRCAUX 
VMFRCUPD 
VMFRCCOM 
VMFRCCOM 
VMFRCCOM 


VMFRCCOM 
VMFRCCOM 


VMFRCUPP 


* PARTTYPE EXEC 


Kk 
TXT* 

*x* 

*k 


TAM* 
TKA* 
TUC* 
TPO* 
TFR* 
TGR* 
AUXXA 
AXA* 
AUXMXA 
AXM* 
EXEC 
MACRO 


ee Rey HN NOONE SERIND RENEE TS AANA GILL SNEED EN CON NN SI SOS SL NG NY ORT AL OE ONS MD A SN SN NE A AD SR SA OD SU LD AE SN SN NN A A AE A A OL AES NS SOL SSE SOON SOS AE A SENG SRR GTN Se MDGT ANE DONG SRGE SPO OGD GomeE STUNT SN SUS See Gem SN 


*#* 


VMFAPTXT 


VMFAPNLS 
VMFAPNLS 
VMFAPNLS 
VMFAPNLS 
VMFAPNLS 
VMFAPNLS 
VMFAPAUX 
VMFAPAUX 
VMFAPAUX 
VMFAPAUX 
VMFAPCOM 
VMFAPCOM 
VMFAPCOM 
VMFAPCOM 
VMFAPCOM 


* BUILDLST EXEC 


** 


CMSLOAD VMFBDNUC 


** 


TARGET 
DELTA1 
DELTA1 


DELTA1 
DELTA1L 


DELTA1 
DELTA1 
DELTA1 
BUILD1 
DELTA1 
BUILD1 
BUILD2 


BUILD4 


RENAME 
TEXT 
TXTAMENG 
TXTKANJI 
TXTUCENG 
TXTPORTG 
TXTFRANC 
TXTGER 
AUXXA 


AUXMXA 


TARGET 


BUILD1 


406 Installation and Service 


a a a i a i a ee a a ee, a ae, a. 2 + 


* 


DESCRIPTION 


Apply and Exclude lists 

PTF Parts Lists | 
Update files for CMS ASSEMBLE source 
Text replacement modules for CMS 

Text shells created on target disk 
Update shells created on APPLY disk 

AUX files for updates to non-ASSEM parts 
Update files for non-ASSEMBLE parts 

New Source (assemble,macro,copy,$exec...) 
Maclibs go directly to the Build disk 
Replacement parts and regenerated 

parts other than maclibs, text, modules 
CMS/IOCP modules go directly to the 
Build disk 

AMENG HELP files go directly to the 
AMENG help Build disk 

UCENG HELP files go directly to the 
UCENG help Build disk 

IOCP files go to the DELTA1 disk 
Reserved parts 

ptf numbered parts other than TXT 


Apply Function 


DESCRIPTION 

Create AUX and rename appropriate update 
files to fm5 for names in loadlist. 
Other TXT parts renamed to TEXT 

For American English NLS support 

For KANJI NLS support 

For Uppercase English NLS support 
For Brazilian Portuguese NLS support 
For French NLS support 

For German NLS support 

For EXEC AUX files 

For EXEC AUX files 

For MACRO AUX files 

For MACRO AUX files 

ALL PARTS ARE LISTED BY FILETYPE 

If a part type is not listed 


VMFAPCOM is called by default 
Build Function 
DESCRIPTION 


Create CMS nucleus based on loadlist | 


Ee eee 


CPYSYSCM VMFBDCPY BUILD1 * Copy TEXT decks that do not become 


* * part of a MODULE to the system disk 
kk 
CPYBTHCM VMFBDCPY DELTA1 * Copy TEXT decks used by CMSGEND and 
** * listed in the load list, CMSLOAD EXEC, 
*k * to the DELTA disk. VMFAPPLY only 
*e * copies the ones not listed in the load 
** © List. 
*k* 
* CPYGNDCM VMFBDCPY DELTAl * Copy TEXT decks used by CMSGEND which 
*x * are not listed in the load list, 
** * CMSLOAD EXEC. This list would be used 
ek * if you have local modifications and 
cha * you choose not to run VMFAPPLY. All 
*k * TEXT decks for which you have received 
* ~* service and/or have local mods would 
** * be copied as a result. You need to remove 
*x * the asterisk before CPYGNDCM before 
Kk * running VMFBLD. 
*k * Use CMSGEND to build CMS modules 
ee eee eee = 
: END * End of Parameters for CMS 
$e ee = oor ee SS SS SS EE eS eS eS ES ee LS LL LS SS SS 
$e ee ee ee SE oS Se a eS SS SS Se a SS SD SS SN SS ONS NS NE ST SS SE OS NS SN CSS SLE LY ES AS ST SS SE 
:CORCMS. CMS * Start of CMS Corrective Service Overrides 
Sor eee eee ee 
:UPDTID. AUXCOR * COR service applied at AUXCOR level 


* 


:MERGE. LOCAL1 
:MDA. UPDATE 
LOCAL1 395 691 * Merge doesn't go to SUP reach-ahead disk 
APPLY 395 691 391 692 392 * LOCAL1 disks added to APPLY string 
DELTA1 395 691 391 593 293 ™* LOCAL1 disks added to DELTAI1 string 


Merge only LOCAL1 not APPLY and DELTA] 


Kee i ee eee == 
: END * End of CMS Corrective Service Overrides 
Bee ne eee eee ede ee eee eee ee eee endeared ene ee eee eevee ete eee eee eee eee eee 
ote erent enttent erent entent estes eetee enteetee ete eee eteetetet tn! 
:DV * Start of Parameters for DV 

Ker a i se sss = 
:CNTRLOP. * Section one - Control Options 

ee * DO NOT DELETE THESE CONTROL TAGS 

* TAG VALUE(S) * DESCRIPTION 

kk 

:CNTRL. HCSXA * Control File name 

:UPDTID. | AUXXA * Update level identifier for building AUX 
sSLVI. H/HP H/PP * System level and version indicators 

2NLS. AMENG * System Language 

sUSEREXIT. VMFUEDV * User exit EXEC. Called before initial 

ae * accesses and after final access retore. 
ai * 2 paramters passed will indicate calling 
ee * EXEC and SET-UP or CLEAN-UP. 

:MERGE. DELTA1 APPLY LOCAL1 

ca * Disk strings to be merged at Receive 
:LTO. NO * Erase lower level TEXT decks at Receive 
:CKTXT. YES * Check for full text at Apply 

:CKUPD. NO * Check update fm regardless of $PTFPART fm 
:CKAUX. YES * Check composite AUX at Build 

:CKREQ. YES * Check Requisites at Build 

iS cc it i mi cm a is nil i ns a i esi in i i Ss i Ci i cS ees Si ns i mat om Si ss i wi ine ws nn wc is ns mn arnt msn is it wn is a i 


SE EE ES SS A ES SE ES LS SS TE A SS A ES SS ES 
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>MDA. 


** 


* STRNGNAM MINIDISKS 


** 


*TASK | 
LOCAL1 
*LOCALn 
APPLY 

DELTA1 
*DELTAn 
BASE1 

*BASEn 
BUILD1 
BUILD2 
BUILD4 
*BUILDn 
SYSTEM 


**k 


:RECSER. 


xk 


* TAPEFILE 


** 
AXLIUST 
PARTLST 
UPDT 
DVFTEXT 


**k 
** 


EXECAUX 

EXECUPD 
** 

SOURCE 

DVFEXEC 


** 
*K 


DVFMODS 


**k 


HELP 


**k 


HELP 
** 

RESV 

PTFS 


191 


395 691 391 


692 392 
593 293 


193 
490 


49D 
49C 


191 295 591 291 59 


EXEC 


VMFRCAXL 
VMFRCCOM 
VMFRCUPD 
VMFRCTXT 


VMFRCAUX 


VMFRCUPD 


VMFRCCOM 


VMFRCCOM 


VMFRCCOM 


VMFRCCOM 


VMFRCUPP 


*VMFRCCOM 
VMFRCCOM 


* PARTTYPE EXEC 


** 
TXT* 

Kk 

** 


TAM* 
TKA* 
TUC* 


VMFAPTXT 


VMFAPNLS 
VMFAPNLS 
VMFAPNLS 


TARGET 


DELTA! 
DELTAI 
DELTA1 
DELTA] 


DELTA1 


DELTAI1 


DELTA] 


BUILD1 


BUILD1 


BUILD2 


BUILD4 


DELTAI 


DELTAI 


RENAME 


TEXT 


* Section two - Mini-Disk Assignments 
* STRING NAMES MUST START IN COLUMN 1 
* DESCRIPTION 


+ + +S FF F FF * HF HF HF F HF F 


+ + Fe  F FF HF HF HF HF HF F HF HF HF HF F * 


+ 


* 
* 
* 


TXTAMENG * 
TXTKANJI * 
TXTUCENG * 
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Build disks accessed before rest of dbase 


Disks for corrective and local service 
You may define additional LOCAL disks 
Control structure built by service execs 
DV service from TAPE 

You may define additional DELTA disks 

DV text, loadlist,control file,maclibs 
You may define additional BASE disks 

New system disk for CMS and Dump Viewer 
New CMS system disk for AMENG HELP files 
New CMS system disk for UCENG HELP files 
You may define additional BUILD disks 
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Disks reqd for your system environment. 
CP database needed for MACLIBs. If 
latest MACLIBs are on a build disk, only 
that disk must appear here. 


Receive (Service) 


DESCRIPTION 


Anonly and Exclude lists 

PTF Parts Lists 

Update files for HCSTBL ASSEMBLE source 
Text replacement modules for DV 

Text shells created on target disk 
Update shells created on APPLY disk 

AUX files for updates to non-ASSEM parts 
XEDIT updates to DELTA disk 

(DVFXEDIT $XEDIT and FINDUSER $XEDIT) 
New Source (assemble,macro,copy,$exec... 
DUMP VIEWING EXECs go directly 

to the Build disk 

includes CPBLOCK CBMAP and HCSCP1 TABLE 
DUMP VIEWING modules go directly 

to the Build disk 

AMENG HELP files go directly to the 
AMENG help Build disk 

UCENG HELP files go directly to the 
UCENG help Build disk 

Reserved parts 

PTF numbered parts other than TXT 


Apply Function 
DESCRIPTION 


Create AUX and rename appropriate update 
files to fm5 for names in loadlist. 
Other TXT parts renamed to TEXT 

For American English NLS punnere 

For KANJI NLS support 

For Uppercase English NLS support 


a 


TPQ* VMFAPNLS TXTPORTG * For Brazilian Portuguese NLS support 
TFR* VMFAPNLS TXTFRANC * For French NLS support 


TGR* VMFAPNLS TXTGER * For German NLS support 

AUXXA VMFAPAUX * For EXEC AUX files 

AXA* VMFAPAUX AUXXA * For EXEC AUX files 

EXEC VMFAPCOM - 
aa VMFAPCOM * ALL PARTS ARE LISTED BY FILETYPE 
sae VMFAPCOM * If a part type is not listed 
PM 5 VMFAPCOM * VMFAPCOM is called by default 
:BLD. * Build Function 
** 
* BUILDLST EXEC TARGET * DESCRIPTION 
k* 

CPYSYSDV VMFBDCPY BUILD1 * Copy DV Interface Files to System disk 
kk 
— * Use UTILITY DVFGEND to build Dump Viewer 
ee eee eee ee eee ee === == 
> END * End of Parameters for DV 
Beer rer esheets ere mee ee eee beef ee fen enone renee mee nee oe ee vee ete peer eee eee ore eee eee ent veneer nee refed aoed ed neared eb ve eee oeet eed evden echoed 
6 eee eee = 
:CORDV. DV * Start of DV Corrective Service Overrides 
er eee eae = 
:UPDTID. AUXCOR * COR service applied at AUXCOR level 
:MERGE. LOCAL1 * Merge only LOCAL1 not APPLY and DELTA1 
sMDA. UPDATE 
LOCAL1 395 691 * Merge doesn't go to SUP reach-ahead disk 


APPLY 395 691 391 692 392 * LOCAL1 disks added to APPLY string 
DELTA1 395 691 391 593 293 ™* LOCALI disks added to DELTA1 string 


Fe re re a wv os ep ec a nS se eo i a oS oe oe om 
> END * End of DV Corrective Service Overrides 
eee ee er or ee ee ee ee a 
Fe mn em sm sen em ev rs a i ee sev i i i a i ie i eo pe ie 
:GCS * Start of Parameters for GCS 

* eo ee a eee eae = 
:CNTRLOP. * Section one - Control Options 

is * DO NOT DELETE THESE CONTROL TAGS 

* TAG VALUE(S) * DESCRIPTION 

kk 

sCNTRL. CSIXA * Control File name 

sUPDTID. | AUXXA * Update level identifier for building AUX 
sSLVI. H/CI * System level and version indicators 

:NLS. AMENG * System Language 

:USEREXIT. VMFUECMS * User exit EXEC. Called before initial 

= * accesses and after final access retore. 
= * 2 paramters passed will indicate calling 
ae * EXEC and SET-UP or CLEAN-UP. 

:MERGE. DELTA1 APPLY LOCAL1 

ae * Disk strings to be merged at Receive 
:LTO. NO * Erase lower level TEXT decks at Receive 
:CKTXT. YES * Check for full text at Apply 

:CKUPD. NO * Check update fm regardless of $PTFPART fm 
:CKAUX. YES * Check composite AUX at Build 

:CKREQ. YES * Check Requisites at Build 

Se eee esses = 
:MDA. * Section two - Mini-Disk Assignments 

si * STRING NAMES MUST START IN COLUMN 1 

* STRNGNAM MINIDISKS * DESCRIPTION 
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Kk 


Build disks accessed before rest of dbase 
Disks for corrective and local service 
You may define additional LOCAL disks 
Control structure built by service execs 
GCS service from TAPE 

You may define additional DELTA disks 
GCS text, loadlist,control file,maclibs 
Nucleus, LOADLIB, EXECs 

GCS source files ASSEMBLE, $EXEC,$XEDIT 
You may define additional BASE disks 

New GCS system disk for nucleus etc. 

New GCS system disk extension 

New CMS system disk for AMENG HELP files 
New CMS system disk for UCENG HELP files 
New CMS system disk for GCS Interface 
You may define additional BUILD disks 
293 193 

Disks reqd for your system environment. 
CMS database needed for MACLIBs. If 
latest MACLIBs are on a build disk, only 
that disk must appear here. 


Receive (Service) 
DESCRIPTION 


Apply and Exclude lists 

PTF Parts Lists 

Text replacement modules for GCS 

Text shells created on target disk 
Update shells created on APPLY disk 

AUX files for updates to non-ASSEM parts 
Update files for non-ASSEMBLE parts 

NEW SOURCE FILES GO ON DELTAI1 

Maclibs go directly to the Build disk 
Replacement parts and regenerated 

parts other than maclibs, text, modules 
GCS modules go directly to the Build disk 
AMENG HELP files go directly to the | 
AMENG help Build disk 

UCENG HELP files go directly to the 
UCENG help Build disk | 

Reserved parts 

PTF numbered parts other than TXT 

Text replacement GCS interface files. 
Text shells created on target disk 
Update shells created on APPLY disk 


*TASK 191 * 
LOCALL 495 791 491 * 
*LOCALn * 
APPLY 892 592 * 
DELTAL 896 596 * 
*DELTAn * 
BASE1 595 * 
** * 
*BASE2 * 
*BASEn * 
BUILD1 895 * 
BUILD2 — 89E * 
BUILD3 49D ' 
BUILD4 49 * 
BUILDS = 490 * 
*BUILDn * 
SYSTEM 191 395 691 391 593 
** * 
** * 
*K* * 
** * 
: PRTFNC. * 
:RECSER. * 
** 

* TAPEFILE EXEC TARGET * 
** 

AXLIST VMFRCAXL DELTA1  * 

PARTLST VMFRCCOM DELTAl * 

TEXT | VMFRCTXT DELTAL * 
Kk * 
**k * 

EXECAUX VMFRCAUX DELTAl * 

EXECUPD VMFRCUPD DELTAl * 

SOURCE VMFRCCOM DELTAl * 

MACLIB VMFRCCOM BUILD1  * 

EXEC VMFRCCOM DELTA1 * 
*Kk * 

MODULE  VMFRCCOM BUILD1 * 

HELP _VMFRCCOM BUILD3  * 
Kk * 

HELP | VMFRCUPP BUILD4 * 
Kk * 

RESV  *VMFRCCOM DELTA1 = * 

PTFS  VMFRCCOM DELTAL * 

GCSCMS VMFRCTXT DELTA * 
** * 
** * 
:APP, * 
** 

* PARTTYPE EXEC RENAME * 
** 

TXT* -VMFAPTXT TEXT —* 
*K* * 
kk * 

TAM* VMFAPNLS TXTAMENG * 

TKA*  VMFAPNLS TXTKANJI * 
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Apply Function 
DESCRIPTION 


Create AUX and rename appropriate update 
files to fm5 for names in loadlist. 
Other TXT parts renamed to TEXT 

For American English NLS support 

For KANJI NLS support 


ny 


paneer 


TUC* VMFAPNLS TXTUCENG * For Uppercase English NLS support 
TPO* VMFAPNLS TXTPORTG * For Brazilian Portuguese NLS support 
TFR* VMFAPNLS TXTFRANC * For French NLS support 
TGR* VMFAPNLS TXTGER * For German NLS support 
AUXXA VMFAPAUX * For MACRO and EXEC AUX files 
AXA* VMFAPAUX AUXXA * For MACRO and EXEC AUX files 
EXEC VMFAPCOM ig 
MACRO VMFAPCOM * 
ial VMFAPCOM * ALL PARTS ARE LISTED BY FILE TYPE 
as VMFAPCOM * If a part type is not listed 
we VMFAPCOM * VMFAPCOM is called by default 
* sr sss see = 
:BLD. * Build Function 
** 
* BUILDLST EXEC TARGET * DESCRIPTION 
** 


| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| GCSLOAD VMFBDNUC BUILD1 * Create GCS NUCLEUS based on LOADLIST 
|, ee * Use GROUP EXEC to build GCS Macilbs 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


( CPYGCS VMFBDCPY BUILD5 * Rename/Copy GCS Interface Files, needed 
aa ae * for DUMPSCAN formatters, these are 
am * TEXT decks. 
** 


* CPYOTHGC VMFBDCPY DELTAI1 PMX modules or TEXT decks, message 


id exchangers, loaded in SNA program 


* 
* 
as * products, that do not become part of 
kas * the GCS nucleus. If you choose not 
* to run VMFAPPLY, this list would 
* copy these text decks to the 
* 


DELTA disk during the VMFBLD process. 


OE SY LT A LY AT TT AE OA A CORN ORNS SLY SL SE SEE SUES SOS GEL AOE ET AER GR SDE SN HS AN CR SIE GE RE ENS SE Se SIT ANE RES SEN SS SOE SLED SONS OTS ES LE ES AO CS SS GL SOE CTE RTE WINN SOR Salton MeN SR Mee SAO 
OS eS AS NS CL SE SA SD ER EE SE SL ON SD SRS NS GE SUED SINAN GOREN CORALS SENN HUN SY GAN SEED OR GAREY CLT AOE IN CHEE ENS EE OS SE SS SN OE SN RE NS ND SE A SS SS SS SS SS Se aS LS SS SS SNS Sie GONE SEND SUL CE rom 
a CA ORNS SR OR NE SS A EE A A LL AT AS TA SL AOS SED ERIANS SaeD StU OREN CORED Stell ENE COE LOE GRENSON OES AOE EE SE OOS TN NS I EY NE SL SE SD SE SN RE SO RR A A IS AED OLN SRN CURA Min Fan SO SR 


| 
| 
| 
| :UPDTID. AUXCOR * COR service applied at AUXCOR level 

| :MERGE. LOCAL1 * Merge only LOCAL] not APPLY and DELTAI1 

| :MDA. UPDATE 

| LOCAL1 495 791 * Merge doesn't go to SUP reach-ahead disk 
| 

| 

| 

| 

| 


APPLY 495 791 491 892 592 * LOCAL1 disks added to APPLY string 
DELTA1 495 791 491 896 596 * LOCAL1 disks added to DELTA! string 


Warning: The disk addresses in the SPLOAD PROFILE, the user directory, 56643082 $PPF, and the 
SETUP EXEC must all match the default addresses the ITASK EXEC uses. If you change an address in any 
one of these places, you must change it in all the others. We recommend that you do not change any 
addresses. | 
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The Tags in the Product Parameter File 


Product Area 


:>COMPLST. compnamel compname?2 ... compnamen comment 


:>COMPLST. 
is a list of the components in the product. It can be specified only in the product area of the base 
product parameter file (where it is required), not in an override file. 


compname 
is an unofficial nickname, in upper case, for the component. The first component of the product on 
the PUT gets the first compname in the list, the second component the second compname and so on. 


comment 
is any string prefixed with an asterisk. A comment can appear after any of the tags or on a line by 
itself anywhere in the product parameter file. 


SOVERLSTP. overnamel overname?2 ... overnamen 
is a list of override names that you want VMFOVER to prompt you with, in addition to ne list of 
component names following the :COMPLST. tag, if VMFOVER is invoked without a component being 
specified. If you do not want VMFOVER to prompt you with any override names, specify :OVERLSTP. 
followed by an empty list. 


If you do not specify the :OVERLSTP. tag, the names following the :OVERLST. tag are used for 
prompting. You do not have to list the override names twice. You will be prompted only once for any 
name listed on both tags. 


The :OVERLSTP. tag is required in the product area of the base product parameter file and permitted in 
the product area of a separate override file. It is not allowed in the component override section of either 
file. 


-OVERLSTP. must always be placed between the :COMPLST. tag and the :OVERLST. tag in the PPF. 


SOVERLST. overnamel overname?2 ... overnamen 
is a list of override tags, each one related to a specific component. Several override tags can relate to the 
same component, but each override tag can only relate to one component. 


If you do not specify the :OVERLSTP. tag, the names following the :OVERLST. tag are used for 
prompting. You do not have to list the override names twice. You will be prompted only once for any 
name listed on both tags. 


The :OVERLST. specification is required in the product area of both the base product parameter file and 
the separate override file. It is not allowed in the component override section of either file. 


-OVERLST. must always be placed after the :OVERLSTP. tag in the base PPF. 


Component Area 


:compname. 
is an uppercase delimiter for the part of the PPF describing the component named. compname is one of 
the components named in :COMPLST. The end of the component part of the PPF for this component is 
delimited by a corresponding :END. tag. 


Control Options 


<CNTRLOP. 
is the delimiter for the component section of the PPF defining general parameters for the component. 


:<CNTRL. control_file_name 
is the filename of the control file to be used to service, assemble, and/or build this component of the 
product. 
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SSLVI. pl/ssl p2/ss2 ... pn/ssn 


:SLVI 


is a list of the system level and version indicators used as a prefix and suffix, concatenated with the 
numeric portion of the APAR number, to form the filetype of the update file. 


p/ss 
is a word that consists of two values separated by a slash. The first value, represented by a p, is the 
single character prefix in the update file filetype. The second value, represented by ss, is the 
2-character suffix in the update file filetype. 


:NLS. langid 


is specified to be one of the following: AMENG, KANJI, UCENG, PORTG, FRANC, or GER. For 
CP and CMS the default is AMENG. 


-LTO. YES|NO 


:<LTO. 
The Last Text Only option erases lower level text decks during receive. Duplicate text decks are 
n never created, regardless of the setting of the LTO option (yes or no). 
( : YES 
“ indicates that during VMFREC a search is made for other text decks with the same filename and 
filetype prefix in the target minidisk string. If other decks exist, the PTF information in each text 
deck prologue is checked and only the latest text deck, including the one just read in, is kept on the 
DELTA disk. The latest text deck includes the accumulation of all service in the decks being 
replaced. If this is not the case an error is included in the receive exception log. This requires write 
access to all DELTA disks on which text decks may exist. 


NO 


a indicates that existing text decks for different PTFs are left as they are. If a text deck exists for the 
( , same PTF the new one is not kept. 


>CKAUX. YES|NO 


:CKAUX. 
Check composite AUX at build. The value of this tag may be overriden by using the CHECK or 


NOCHECK option on VMFBLD. CHECK is equivalent to :CKAUX. YES and NOCHECK is 
equivalent to :CKAUX. NO. 


YES 


— indicates that all AUX and update entries in the text deck should be verified against the AUX 
( control structure to be sure the correct deck has been located. 


NO 
indicates that only the entries in the AUX file used to locate the text deck will be verified against the 


text deck prolog. Additional entries in the text deck prolog are not verified for faster completion of 
the build process. 


>CKREQ. YES|NO 


:-CKREQ. 
Check requisites at build. The value of this tag may be overridden by using the CHECK or 
NOCHECK option on VMFBLD. CHECK is equivalent to :CK REQ. YES and NOCHECK is 
equivalent to :CKREQ. NO. 


YES 


indicates that requisite information chains will be verified to assure that all required PTFs related to 
the ones applied are included in the system being built. The update files contain entries for 
PREREQ, CO-REQ and IF-REQ. 
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PREREQs and CO-REQs describe dependencies in the same product. If the dependency is in the 
same component, the 7-character APAR number is listed (for example, VM12345). If the 
dependency is in another component of the same product the APAR number and component ID are 
included in parentheses following the PTF number, for example, UV54321(VM12345-56630130). 


If the dependency is in another product, an IF-REQ is used. An IF-REQ contains a PTF number 
rather than an APAR number. The APAR number and component ID are included in parentheses 
following the PTF number, for example, UV54321(VM12345-56630130). 


NO 
indicates that requisite information chains as contained in the text will not be verified during the 
VMFBLD EXEC. 


-CKUPD. YES|NO 


:<CKUPD. 
Check and apply PTFs whether or not they have already been applied. A filemode of 5 on the 
$PTFPART list indicates that a PTF has been applied. 


YES 
indicates that a filemode of 5 on a $PTFPART list is not sufficient to prevent a PTF from being 
applied. Additional processing is performed for each part in the list. This makes it possible for the 
same PTF to be processed more than once. 


NO 
indicates that filemode 5 on the $PTFPART list will prevent the same PTF from being processed 
more than once. If the PTF has already been successfully applied as indicated by its filemode all 
further processing for this PTF is bypassed. 


:-CKTXT. YES|NO 


<CKTXT. 
Check for full text at apply. The value of this tag may be overridden by using the CHECK or 
NOCHECK option on VMFAPPLY. CHECK is equivalent to :CKTXT. YES. NOCHECK is 
equivalent to :CKTXT. NO. : 


YES 
indicates that when VMFAPPLY is complete, if a PTF which has been applied is a text shell and not 
a full text deck including executable code, an error should be placed in the Apply Exception Log. 


NO 
indicates that the application of a PTF which is a text shell will not cause an error in the exception 
log. 


sUPDTID. updateid 
identifies the filetype of an AUX file and should match a filetype listed in the control file. This is the 
level at which AUX files will be updated or created as PTFs are applied. This updateid will be used 
unless you override it by providing an updateid as an argument to VMFAPPLY. 


:USEREXIT. exitname 


SUSEREXIT. 
identifies the user EXEC for setup and cleanup to be called at beginning and end of each service 
function (VMFREC, VMFAPPLY, and so on). 


exitname 
is the name of the user EXEC to be called. The first parameter is the uppercase name of the 
invoking EXEC. The second parameter is either SET-UP or CLEAN-UP, indicating initialization or 
termination. At termination the third parameter is the return code as determined by the invoking 
EXEC. The return code can be changed by the exit. Functions such as link and detach can be 
invoked by the exit. VMFUECP, VMFUECMS, and VMFUEDYV are the default exits provided by 
IBM. These exits are no-ops. 
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> 


derek 


SMERGE. symboil symbol2 ... symboln 


:MERGE. 
is a list of symbolic disk strings (for example DELTA, APPLY) to be merged by VMFREC when the 
product or component being received already exists on the receive target disk. If the target disk does 
not contain the product or component being received, the merge does not take place. 


VMFREC accomplishes the merge by moving the contents of the disk before the last in the string to 
the last disk in the string, then erasing the disk before the last. It repeats this process with the next 
pair of disks, moving one disk to the left in the string each time, until the first disk in the string is 
clear. 


Note: If you want to prevent merging from taking place, see Appendix G, “Controlling Disk String 
Merges” on page 859. 


symbol 
is the symbolic name of a minidisk string such as DELTAI, APPLY, or LOCALI. If the product or 
component is present, as indicated in a file with the filetype $MRxxxxx, on the first disk in any disk 
string in the list, all disk strings in the list are merged. 


Minidisk Assignments: 


Usage Notes: 
¢ Considerations for read-only disks in the product parameter file: 


Disks appearing in the MDA section of the $PPF may be specified as read only by coding a slash (/) 
immediately following the disk address in the symbolic disk string. For example, 


LOCAL 295 591/ 291 
indicates that the 591 disk is to be read only and it will be accessed as mode/mode by VMFSETUP. 
e The last specification wins: 


If the disk address appears in a given section (receive, apply, etc.) more than once, its last specification 
determines its access status. 


e Disks currently accessed R/W: 


If a disk is currently accessed R/W it is released and then accessed mode/mode. Upon performing a 
VMFSETUP restore it will once again be R/W. 


If the disk is R/W and empty (no CMS files on it) the mode/mode fails and a message is issued when the 
using application program attempts to access It. | 


e Merge considerations: 


Do not use read only disks in symbolic disk strings identified as strings to be merged. Merging requires 
write access. 


sMDA. 
is an uppercase delimiter for the section describing the minidisk assignments. 


TASK dddd1 dddd2 ... ddddn 


TASK 
lists the service EXECs build disk. The TASK disk is accessed after the A-disk and before the 
component data base disks. For more information on using the TASK statement to set up a separate 
disk for the service EXECs, see the “Usage Notes” section of the VMFREC EXEC description (on 
page 710). The symbolic disk name TASK must start in column 1. 


dddd 
is the 4-digit disk address of a system minidisk. 
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SYSTEM dddd1 dddd2 ... ddddn 


SYSTEM 
lists the disks required for your working system environment. The symbolic disk name SYSTEM 
must start in column 1. 


dddd — | 
is the 4-digit disk address of a system minidisk. 


BASE! dddd 


BASEn dddd 


BASE1 ... BASEn | 
are the BASE disks created at installation time. You may define additional BASE disks if you have 
specific needs. The symbolic disk name BASE must start in column 1. 


dddd 
is the 4-digit disk address of a BASE minidisk. 


DELTAI1 ddddi dddd2 ... ddddn 


DELTAn ddddl dddd2 ... ddddn 


DELTA! ... DELTAn 
are disks containing service from the PUT. You may define additional DELTA disks. The symbolic 
disk name DELTA must start in column 1. 


dddd 
is the 4-digit disk address of a DELTA minidisk. 


ADDIV ddddl ddddd | ddddn 
APPLY | 
identifies the control structure to be built. AUX files and update shells are created on the APPLY 


minidisks. There is only one symbolic string of APPLY minidisks. The symbolic disk name APPLY 
must start in column 1. 


dddd 
is the 4-digit disk address of an APPLY minidisk. 


LOCAL] dddd1 dddd2 ... ddddn 


LOCALn ddddl1 dddd2 ... ddddn 


LOCAL ... LOCALn | 
are disks for local service and corrective service. You may define additional LOCAL disks The 
symbolic disk name LOCAL must start in column 1. 


dddd 
is the 4-digit disk address of a LOCAL minidisk. 


BUILD1 dddd 


BUILDn dddd 


BUILD! ... BUILDn | 
are the new system residence disks for CP nucleus build. You may define additional BUILD disks. 
The symbolic disk name BUILD must start in column 1. 


Warning: The :BUILD1. tag does not force the nucleus to i built on the specified disk. Make sure 
that the HCPSYS ASSEMBLE file (for CP), the DMSNGP profile (for CMS), or the saved system 
information panel (GRP121, for GCS), indicates the disk where you want to build the nucleus. 
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dddd | 
is the 4-digit disk address of a BUILD muinidisk. 


EXECs 


:PRTFNC. 
is an uppercase delimiter for the section describing the list of the types of parts serviced with the 
functional EXEC assignments and symbolic target disk assignments. 

-RECSER. 


is an uppercase delimiter for the list of functional assignments related to the Receive function (VMFREC 
EXEC). This tag is followed by a list which contains one entry for each possible tape file for the 
component on the PUT or corrective service tape. 


Each tape file contains all the parts of the same or a related type. The attribute that binds the types of 
part in a particular tape file is that they all require the same Receive processing and target minidisk 
symbol. Each part is in a separate CMS file within the tape file. 


tapfil execname target 


| tapfil 
( - is an uppercase mnemonic that symbolizes the content of the tape file it represents. This is the first 
bo symbol in each entry for each tape file on the PUT or corrective service tape. This symbol may start 
in any column. 


execname 


is the name of the EXEC that processes the types of parts found in the tape file represented by this 
entry. IBM provides four part handlers for the Receive function. VMFRCUPD processes update 
files. VWMFRCTXT processes text decks. VMFRCAXL processes apply and exclude lists. 
VMFRCCOM processes all other parts by simply putting them to the target disk. 


An EXEC name starting with an asterisk causes the associated tape file not to be received. © 


target 


is an uppercase symbol corresponding to the minidisk assignment section of the PPF that identifies 
where the parts are to be placed as they are received from the PUT. 


:APP. 


iS an uppercase delimiter for the list of functional assignments related to the apply function 


(VMFAPPLY EXEC). This tag is followed by a list which contains one entry for each type of part for 
the component. 


partype execname rename 


( partype 
~ is an uppercase part filetype or part filetype prefix when terminated by an asterisk. If the partype 
symbol is TXT*, all parts with a filetype starting with the characters TXT are processed by the part 
handler name in this entry. If the symbol is MACRO, all parts with the filetype MACRO are 
processed by the part handler name in this entry. This symbol may start in any column. 


execname 


is the name of the EXEC that processes the types of parts found with the filetype represented in this 
entry. Parts with a filetype for which no partype symbol appears in the list will be processed by the 
common part type handler VMFAPCOM. Two other part handlers are provided by IBM for the 
Apply function. VMFAPTXT processes text decks, VMFAPNLS language versions of text decks. 


rename 


is the new filetype to be given to those parts found to have an existing filetype matching the partype 
symbol in the entry, but not supported by VMFBLD. Parts supported by VMFBLD are not 
renamed. Whether parts are supported is determined by finding the part in the build list. Parts in 


the build list are located by PTF number. Parts not found in the build list are copied with a new 
filetype of rename. 
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:-BLD. 
iS an uppercase delimiter for the list of functional assignments related to the build function (VMFBLD 


EXEC). This tag is followed by a list which contains one entry for each type of part which is built from 
a collection of other parts in the component. This symbol may start in any column. 


bldlst execname target 


bldlst 
is an uppercase filename for the list (build list) of parts to be included in the part being built. Fora 


nucleus this is a load list. 


execname 
is the filename of the EXEC that processes the build list. 


target 
is the symbolic name corresponding to the minidisk assignment section of the PPF that identifies 
where the part being built is to be placed. The minidisk address assigned to the symbol specified 
here should match the SYSRES address specified on the SYSRES macro in the HCPSYS file. 


:END. 
identifies the end of the current component part. The next component in the PPF starts with the next 


:compname. from the :COMPLST. tag. 


Override Area 
sovername. compname ppfname [NEWNAME | OLDNAME] 


sovername. 
identifies the beginning of the override section for a component. This statement does not appear in 


the temporary PPF. 


CUMPnaIne 


is the name of the component specified in the base PPF :COMPLST. that is to be overridden. 


Ppfname 
is the name of the PPF that is to be overridden. If ppfname is not specified, overname and compname 
must be in the same file (that is, the component override is part of the base PPF). 


NEWNAME 
indicates that the filename of the temporary PPF should be the filename of the override file. This 
option cannot be used in the override section of the base PPF (that is, when override and base PPF 


are in the same file). 


OLDNAME 


indicates that the filename of the temporary PPF should be the original filename of the base PPF file. 


OLDNAME is the default if neither OLDNAME or NEWNAME is specified. 


:MDA. [REPLACE | UPDATE] 
:RECSER. [REPLACE | UPDATE] 
:APP. [REPLACE | UPDATE] 
:BLD. [REPLACE | UPDATE] 


:MDA. 
introduces the overrides for the minidisk assignment section of the component area. 


:RECSER. 
introduces the overrides for the list of functional assignments related to the receive function 


(VMFREC EXEC). 


:APP. 
introduces the overrides for the list of functional assignments related to the ADDY function 


(VMFAPPLY EXEC). 
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:-BLD. 
introduces the overrides for the list of functional assignments related to the build function 
(VMFBLD EXEC). 


UPDATE 
indicates that the entries following the tag in the override section will overlay the corresponding entry 
in the base PPF. Any overlaid entry appears as a comment in the temporary PPF. If the entry does 
not exist in the base, the entry will be added at the end of the section in the base PPF. UPDATE is 
the default if neither UPDATE or REPLACE is specified. 


REPLACE 
indicates that all entries in the base PPF are to be removed and replaced by the entries in the 
override PPF. The removed entries do not appear as comments in the temporary PPF. 


Comments or a group of comments beginning with a single asterisk are merged into the temporary PPF 
immediately preceding the next non-comment statement. 


** 


= Comments or a group of comments beginning with a double asterisk are merged into the temporary PPF 
( ce immediately following the previous non-comment statement. 


a kkk 
Comments beginning with three asterisks do not appear in the temporary override file. 
ee 


Comments beginning with more than three asterisks are handled as if they began with one asterisk. 


The Product Parameter Override File 


( ie The product parameter override file is a separate file containing tags that you want to override the tags in the 
29 base product parameter file when you build or service your system. The override file permits you to create a 
new version of the product without creating a complete new product parameter file. 


The only difference between a separate override file and the override section of a base PPF is that the 
separate override file begins with an optional :OVERLSTP. tag and an :OVERLST. tag. In a base PPF, 
these tags come immediately after the :COMPLST. tag at the beginning of the file, not in the override 
section. 


The filename of the override file is the name of the new version of the product. The filetype is $PPF. 


( : The following example shows the override file used with the base file 56643082 $PPF to create an alternate 
product identifier (or “alias”) for VM/XA SP. Since the alternate product identifier is VMXA, the override 
file is called VMXA $PPF. 


Note: If you want to invoke any overrides from the override section of the base product parameter file, for 
example, the corrective service overrides, you must copy them to the separate override file. 


Save override files on the CMS alternate LOCALI (395) disk. IBM suggests that you should also 
save the updated product parameter file there. 


Figure 29 is an example of a product parameter override file. 
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* This is the alias override for the VM/XA Product 56643082 
sOVERLST. CP CMS DV GCS a 

*** The overlst statement will not appear on the temporary composite 
*** product parameter file. 


:CP. CP 56643082 Get the base unmodified PPF from the CP 
aoe file named 56643082 $PPF 

:END. End of current component section 

:CMS. CMS 56643082 NEWNAME Get the base unmodified PPF from the CMS 


kkk 


* 
* 
* 
* 
* file named 56643082 $PPF 

:END. * End of current component section 

:DV. DV 56643082 * Get the base unmodified PPF from the DVF 
* 
* 
* 
* 
* 


kK file named 56643082 $PPF 

:END. End of current component section 

:GCS. GCS 56643082 NEWNAME Get the base unmodified PPF from the CMS 
kkk 


file named 56643082 $PPF 


sEND. End of current component section 


Figure 29. Example of a Product Parameter Override File (VMXA $PPF) 


The Temporary Product Parameter File : ae 


VMFREC, VMFAPPLY, VMFHASM, and VMFBLD all invoke the VMFOVER EXEC to create the 

temporary product parameter file from the product parameter file and sometimes the product parameter 

override file. The temporary product parameter file is a copy of the product area and one component area of 

the base product parameter file, with the tags from the override section or override file substituted where 

appropriate. If you specify the UPDATE option (the default) in the overrides, the overridden tags are 

included in the temporary PPF as comments. If you specify the REPLACE option, the overridden tags are 

not included. All the installation and service EXECs use this copy instead of the base PPF. | a 


If you use a separate override file and specify the NEWNAME option on the :compname. tag in the override 
file the filename of the copy is the filename of the override file. Otherwise, it is the filename of the base PPF. 
The filetype of the copy is $PPFTEMP. 


To see the temporary product parameter file before you run a service EXEC, invoke VMFOVER from the 
command line. You can also examine the temporary product parameter file after running the service EXECs. 
It is not erased. 


Many different temporary product parameter files can be created from the base file on page 402, 56643082 ao, 
SPPF. In the simplest example, if you issue this command: a 
vmfover 56643082 cp = | 

you will get a temporary file just like the CP section of the base file, like the file in Figure 30 on page 421. 


ete ee 
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Serre oe ere eet 
*aaaa======> * Temporary override of CP component 
*emmessss==> * jin PPF of product 56643082 
Keer Sas coon coe ean aunt SnnS Stee Sova? SE! SDN SOD SS SEES SNe SSN! SOE OD SESS SAD SOA AD Gan Sham oe GON SSNS SISO Somes pea AOE SED Sees aa Somes Sana SNS SSD See Seen cones Sosa SR 
xxxeKEEK = =PRODUCT PARAMETER FILE ******* 
* 
* 
xkkkkX = =Product Parameter File for 
KEK KKK VMXA SP 2 
* 
*kkkE* NOTE: All tags must be in upper case. 
* 
Reo eee eee eee eee es eee eee 
*aassss==== Product Header 
eoce i  eeeeeeeeeeeee= 
*ekEXX List of Components in VMXA SP 2 
* 

7 :COMPLST. CP CMS DV GCs 

( : :OVERLSTP. 

: sOVERLST. | CORCP CORCMS CORDV CORGCS : 
* 
Re ee eee eee ee eet 
*#=aaa=e===== End of Product Header 
SPs cus i cass vi wim es mi a i im mei ci i inl his inn ts en ns ems in sens i ni em ion‘ tm Cen ii mse ee ans ms mm in nin niin <i ei in ins i eh i Ga em ens is is it i's ims Get i is ih 


KKEKEKKEEKKEKREKEKKEKKREKRERKRREKKEEKK 


:CP. * Parameters for CP 
KKKRKKKKKRR RAK KK RRR KR KR KR 


(O2TE GPE AAR GN ORS NERD ENT) MARIS AINE PND SOND NET CAMEO LNRED GE OENEN GND GAOT EARN GONNN NaN CUNY SUNN GANS SORE GNNNGH GEES GANS GONE GRANEED GERD SENET CULES SERED LOOETS AOR ERY GENE Su CURIE COE GEUEHY GUNES STEN GETED SEED GON suneE> GhuNe aN ae es A ne Ree meee a TE SES SN EOE EE ENS RR RE AES MES SLED AON SN 


:CNTRLOP. * Section one - Control Options 
, * DO NOT DELETE THESE CONTROL TAGS 


RE RED ON TI AI ES SR NS OL CR SE RE A OE EES A AT A SL ONY ke OE SD WD ORS Gaere OED SA PRY ete ce SUA A Eee Aad Ons EE A SED EO eS RE NA AN fem Gime GEE SETAE GRIND ini ae SED OE TMS OE eee Lie GaN TEMES AED Chere eM mind ARE Rie Stitt Are ferme GA SS BA 


:MDA. * Section two - Mini-Disk Assignments 


Figure 30 (Part 1 of 2). 56643082 S$PPFTEMP (Without Overrides) 
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hein. eines eects eae ois epeincees aes) eens! smi Seaenne sieene: Semee Siine an Se Semen, ome! Jeet 


ahah ate REP OR GRINS Giana Geren diem seatsin elinMlb. cusien Cary PED ACS Seat rae eG ST CON CRD Altice AER AS GEA GNEUND CEOS SE ERD GEEY Cee APRS cote WRENS GENES OK GREE AR AY ORT A SEEN Rae GED ORI GRE WL ESSN SE GE EEN SATE a GeO GRRE OR EEE) TT NY SNS Pe OS ERE OR RE vale ES I ae ES ONY OS 


, ae A A aS SAN SEY EL SANUS SONS NN SNAED RT A SLR ONT SNE ERE RIND INE MEY SD SY WINER GENNS SEE ELNPT SURE GIES ADS SNE SEL SEED GES ADU SSS SS SENS GND SA GE SY SNS MNS AOE ATS SEES ONS SRY Se EE AE SANE SAE SENOS SOS HUT AES CANES CLL GG GUY WATTS SOD REN ACER SAEED. SIETE AUD UTES wD SUE 


:RECSER. * Receive (Service) 
* 
sAPP, * Apply Function 
*Seanscrcoccscsss sss see ese 
* 
Sa a ew ee 
:BLD. * Build Function 
* 
sEND. * End of current component section 


SE EE ES EE ES I SE SE Rell SN ERE ELD tS EO OA etd Ey AE Cn mae ely GEES Gomer tale Greed eda eatine sarin co einem Sane (RAY ciaeD Mew “ellie Mets Was Ok GEA SAAD SE Som GEST Geen Gey Caen deien GEES Sed! Covi Weer ear GES Grit amas ane iN Deres Gea AY ota eee SESE Marie Peco mee Riniohe Hob OTD dire 


Figure 30 (Part 2 of 2). 56643082 SPPFTEMP (Without Overrides) 


If you issue: 
vmfover 56643082 corcp su 


you will get a temporary file with overrides from the override section of the base file, like the file in 
Figure 31. 


Note: When you issue VMFREC or VMFAPPLY, use a component name of CP and the COR option 
instead of the CORCP component name to create this temporary file. 


Temporary override of CP component 
in PPF of product 56643082 
by CORCP override section 
of the PPF for the product 56643082 


The following APAR's have been applied to this file: 


VM32064 - 05/24/88 - New Support for Service Enhancements 2.1 
VM32436 - 08/01/88 - New Function for Service Enhancements 2.1 
VM35065 - 01/04/89 - Change to MACUPDT VMFRCUPD in RECSER section 
New load lists in CP/CMS in BLD sections 
VM35315 - 01/06/89 - PE VM35065 Change EXECUPD VMFRCCOM to 
EXECUPD VMFRCUPD in RECSER section of DV and GCS 


* 
* 
* 
* 
* 
* 
* 
* 
* 


Figure 31 (Part 1 of 5). 56643082 SPPFTEMP (With Corrective Service Overrides) 
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| | * VM35316 - 01/06/89 - Remove 19E from SYSTEM disk string 
| | * VM35405 - 01/09/89 - Remove DELTA2 string from GCS section in $PPF 
| * YM36183 - 02/28/89 - Add CPYSYSDV to DV BLD section in $PPF. Requires 
| * Dump View CO-REQ apar VM36326. 
| | * VM36911 - 04/20/89 - Add HELP to DVF section of PPF. Prereqs DVF 
| * PTF which shipped this service HELP (VM36585) 
| | * VM37518 - 06/23/89 - New AUX file part handlers added. New CKUPD tag 
| * added. Reformatted for readability. COR 
| * overrides moved to after base sections. 
| * 
| 5 eee ee oe oe ee eer ee eee ere ee ee oe eee eee eee eee re ele ere are ene eee ener et eee ee eee ee ee ee ene referee ned eee se eee nf  eme ntend meetmetentet e 
i NOTE: All tags must be in upper case. 
| ko Soe cee See Se Se A Sat Se EE SE SS A AD ES SN SOL SE Sa Se Se So See Some eee SSE Saat Soe Secs Sanel” owe Sonar coon site eaein Ocean Sama” cone couae Somat outer Sones Soman ome Soe SIDE SnD Seat SOS SONY Sea ae SA seas Sane SD Somes sane Sanat Sato Sonus Somer Sener 
| $e eee = 
| | * Start of Product Header - List of Components in VM/XA SP Release 2 
| *s2 ee eee == ore Cue Soe ee SUS! ae AO SESS SMEG SSS ANSE SLD SD SN AST AGN SNES COD SSG SLE SS SOS SAS SAT SOLaNS SASS SANS Sones SOO SAN Suan COND SOON SRLS anos Gees SED! 
| :COMPLST. CP CMS DV GCS 
co | sOVERLSTP. 
( | :OVERLST. 
| * End of Product Header 
| * Sas ee te ae ED OD Ae NE SS SD Se Se A SA A ee ae AA Sw a SS Se ae He ee As Ae A Ae Se A oes Oe A Se A Se A Se as SF Se ao Se ae AS Se SA Sc AS SS SAA Saas Gow Saas coun Saas SS SOMES anes Sane SO 
*--—-— aaa ean eae ne core cree cee ee Se ae ee ee OS SE SS SS A eS AT A A A A Se SA Soe A awe Sas Sa? Sem 
:CP * Start of Parameters for CP 
* Caen eas Oe et Sa SO SO SAE SN SS SON AE OE A A NES SO SE A SC A SS Se A a a A Se ae A A A A A A A A A a Ae Se Ses Se So cae aA oe coe eee Sew See San am 
:CNTRLOP. * Section one - Control Options 
a ae * DO NOT DELETE THESE CONTROL TAGS 
( ; * TAG VALUE (S) * DESCRIPTION 
Le kk 
:CNTRL. HCPXA * Control File name 
Sees eee ee eee eee 
:UPDTID. AUXCOR * COR service applied at AUXCOR level 
*sUPDTID. | AUXXA * Update level identifier for building AUX 


:SLVI. H/HP H/PP 
:NLS. AMENG 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| System level and version indicators 
| 

| :USEREXIT. VMFUECP 
| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 


System Language 

User exit EXEC. Called before initial 
accesses and after final access retore. 
2 paramters passed will indicate calling 
EXEC and SET-UP or CLEAN-UP. 

Merge only LOCAL1 not APPLY and DELTA1 


** 
kx 
kK 


* 

* 

* 

* 

* 

* 

:MERGE. LOCAL1 * 
*:MERGE. | DELTA APPLY LOCAL1 
* 

* 

* 

* 

* 

* 


ae Disk strings to be merged at Receive 
:LTO. NO Erase lower level TEXT decks at Receive 
sCKTXT. YES Check for full text at Apply 

:CKUPD. NO Check update fm regardless of $PTFPART fm 
> CKAUX. YES Check composite AUX at Build 

:CKREQ. YES Check Requisites at Build 

SJ sire sa sins Cie nih el i ene ei i's eta: i spin mi sna ms cm Sabin San ac cm eins nie es cs res sre me mS ens ema il sh eens i rn ie i et ns res‘ cn Sumi as en i i Si Sia Sse tcl sata 
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:MDA. * Section two - Mini-Disk Assignments 


ee * STRING NAMES MUST START IN COLUMN 1 

* STRNGNAM MINIDISKS * DESCRIPTION 

*K* 

*TASK 191 * Build disks accessed before rest of dbase 


*LOCAL1 295 591 291 * Disks for corrective and local service 
LOCAL1 295 591 * Merge doesn't go to SUP reach-ahead disk 
*LOCALn * You may define additional LOCAL disks 
*APPLY 492 192 * Control structure built by service EXECs 
APPLY 295 591 291 492 192 * LOCAL1 disks added to APPLY string 
*DELTA1 594 294 * CP service from TAPE 


424 


DELTA1 295 591 291 594 294 * LOCAL1 disks added to DELTAI string 
*DELTAn * You may define additional DELTA disks 
BASE1 194 -* CP text,loadlist,control file,maclibs 
BASE2 394 * CP source,macro defs,and copy files 
*BASEn * You may define additional BASE disks 
*BUILD1 423 * New SYSRES for CP Nucleus Build 
BUILD2 49D * New CMS system disk for AMENG HELP files Pa. 
BUILD3 49 * New CMS system disk for UCENG HELP files | (| 
BUILD4 490 * New CMS system disk for nucleus etc. Non 
*BUILDn * You may define additional BUILD disks 
SYSTEM 191 395 691 391 593 293 193 
— * Disks reqd for your system environment. 
xe * CMS database needed for MACLIBs. If 
** * latest MACLIBs are on a build disk, only 
aie * that disk must appear here. 
K eer ee ee ses eee 
Asa eee ak Re Le ee a 
:RECSER. * Receive (Service) \ 
** 
* TAPEFILE EXEC TARGET * DESCRIPTION 
*K* 
AXLIST VMFRCAXL DELTA1l * Apply and Exclude lists 
PARTLST VMFRCCOM DELTAL * PTF Parts Lists 
UPDT VMFRCUPD DELTAl * Update files for CP ASSEMBLE source 
TEXT VMFRCTXT DELTAL ™* Text replacement modules for CP 
oe * Text shells created on target disk 
oe * Update shells created on APPLY disk a * 
MACAUX VMFRCAUX DELTA1l * AUX files for updates to non-ASSEM parts . / 
MACUPDT VMFRCUPD DELTA1 * Update files for non-ASSEMBLE parts = 
SOURCE VMFRCCOM DELTAl * New Source (assemble,macro,copy,$exec...) 
MACLIB VMFRCCOM DELTAL * Maclibs are not replaced on the base 
EXEC VMFRCCOM DELTAL * Replacement parts and regenerated 
apa * parts other than maclibs, text, modules 
HELP VMFRCCOM BUILD2 ™* AMENG HELP files go directly to the 
ae * AMENG help Build disk 
HELP VMFRCUPP BUILD3 * UCENG HELP files go directly to the 
a * UCENG help Build disk 
RESV *VMFRCCOM DELTA1 ™* Reserved parts 
CPMOD VMFRCCOM BUILD4 * CP modules targeted for system disk 
PTFS VMFRCCOM DELTAl * PTF numbered parts other than TXT | 
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sAPP. * Apply Function 


** 


* PARTTYPE EXEC RENAME * DESCRIPTION 


*K* 


TXT* VMFAPTXT TEXT 


Create AUX and rename appropriate update 
files to fm5 for names in loadlist. 
Other TXT parts renamed to TEXT 

For American English NLS support 

For KANJI NLS support 


** 
kk 


* 
* 
* 
TAM* VMFAPNLS TXTAMENG * 
TKA* VMFAPNLS TXTKANJI * 
TUC* VMFAPNLS TXTUCENG * For Uppercase English NLS support 
TPQ* VMFAPNLS TXTPORTG * For Brazilian Portuguese NLS support 
TFR* VMFAPNLS TXTFRANC * For French NLS support 
TGR* VMFAPNLS TXTGER * For German NLS support 
AUXXA VMFAPAUX * For MACRO and EXEC AUX files 
AXA* VMFAPAUX AUXXA * For MACRO and EXEC AUX files 
EXEC VMFAPCOM am 
MACRO VMFAPCOM * 
* 
* 
* 


co. ae VMFAPCOM ALL PARTS ARE LISTED BY FILETYPE 
( or? & VMFAPCOM If a part type is not listed 
~ alae VMFAPCOM VMFAPCOM is called by default 
* Sa cae none cused Sones sane Soe Sone SUG OASGs Gone Some Saas SE SMG saa Se Seah GEASS SOON SIN ene Sool Soe Sa Saas SNS Me NAY Sate SNS SOA SaAS Sones eee Sues eee Soee Same HE Sa Sama Ge SOS SOME STS SY OE ROD SOE SON SO ON SE SS Se Se Se SS SN SO OS SS Ae A Ss eS 
:BLD. * Build Function 


* BUILDLST EXEC TARGET * DESCRIPTION 


kk 


CPLOAD VMFBDNUC *BUILD1 


kk 


Create CP nucleus based on loadlist 
Target disk symbol agrees with 

disk address in HCPSYS ASSEMBLE 

on the SYSRES macro. Defaults to 
what is in HCPSYS ASSEMBLE if no 
target disk is specified. 


** 
kk 
ek 


t+ $F HF ee EF F 


**k 
kk 


CPYSYSCP VMFBDCPY BUILD4 * Copy TEXT decks that do not become 
aad * part of a MODULE to the system disk 


kk 


CPYBTHCP VMFBDCPY DELTA1 Copy TEXT decks used by UTILITY and 
listed in the load list, CPLOAD EXEC, 
to the DELTA disk. VMFAPPLY only 
copies the ones not listed in the 


load list. 


+ 
* 
+ ££ £ SF 


Kk 


* CPYUTLCP VMFBDCPY DELTA1 


ak 


Copy TEXT decks used by UTILITY which 
are not listed in the load list, 
CPLOAD EXEC. This list would be used 
if you have local modifications and 


* 
* 
**k * 
* 
** * you choose not to run VMFAPPLY. All 
* 
* 
* 
* 


** 


me TEXT decks for which you have received 
service and/or have local mods would 

be copied as a result. You need to remove 
the asterisk before CPYUTLCP before 


** 
** 


** 
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x * running VMFBLD. 
| a | * Use UTILITY to build CP Utilities 


END. * End of Parameters for CP 


Figure 31 (Part 5 of 5). 56643082 $PPFTEMP (With Corrective Service Overrides) 


If you issue: 
vnfover vmxa cp m= 


you will get a temporary file, like the file in Fai 32, with overrides from the alias override file, VMXA 
$SPPF. 


Temporary override of CP component 
in PPF of product 56643082 


by CP override section -_ 
of the PPF for the product 56643082 Ne sal 
* 
* The following APAR's have been applied to this file: 
* 
* VM32064 - 05/24/88 - New Support for Service Enhancements 2.1 
* VM32436 - 08/01/88 - New Function for Service Enhancements 2.1 : a 
* VM35065 - 01/04/89 - Change to MACUPDT VMFRCUPD in RECSER section YY 
* New load lists in CP/CMS in BLD sections 7 
* VM35315 - 01/06/89 - PE VM35065 Change EXECUPD VMFRCCOM to 
i EXECUPD VMFRCUPD in RECSER section of DV and GCS 
* VM35316 - 01/06/89 - Remove 19E from SYSTEM disk string 
* VM35405 - 01/09/89 - Remove DELTA2 string from GCS section in $PPF 
* YM36183 - 02/28/89 - Add CPYSYSDV to DV BLD section in $PPF. Requires 
Dump View CO-REQ apar VM36326. 
* VM36911 - 04/20/89 - Add HELP to DVF section of PPF. Prereqs DVF 
* PTF which shipped this service HELP (VM36585) ns 
* VM37518 - 06/23/89 - New AUX file part handlers added. New CKUPD tag py 
* added. Reformatted for readability. COR Mae 
* overrides moved to after base sections. 
* 
Scorsese 
. NOTE: All tags must be in upper case 


% 


* Start of Product Header - List of Components in VM/XA SP Release 2 


:COMPLST. CP CMS DV GCS 
sOVERLSTP. 
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:OVERLST. 


ES ee SS NE TY NS SRS SNES SNES Me RANEY SN GENAD ORAS SHED SNE, SOGRN ON GRMN GUND SSE GED ERE SE ERNE SWNT SA MRE we 


:CP. * 
$e ear 
=CNTRLOP. 

** 

* TAG VALUE(S) 

k* 

:CNTRL. HCPXA * 
sUPDTID. | AUXXA * 
:SLVI. H/HP H/PP * 
sNLS. AMENG = 
sUSEREXIT. VMFUECP * 
** * 
** *& 
k* * 
sMERGE. DELTA1 APPLY LOCAL1 
** * 
:LTOQ. NO x 
:CKTXT. YES * 
:CKUPD. NO * 
:CKAUX. YES 52 
:CKREQ. YES * 
Je mae cece canes are ee eats tn OUND HES HOA AR OPED SS SOG SE ONG SID SIND O86 SR WO AD SR END SRD nn sm 


:MDA. 

** 

* STRNGNAM MINIDISKS 

K* 

*TASK 191 = 
LOCAL1 295 591 291 * 
*LOCALn * 
APPLY 492 192 = 
DELTAL 594 294 = 
*DELTAn * 
BASE1 194 * 
BASE2 394 * 
*BASEn - 
*BUILD1 423 
BUILD2 49D 7 
BUILD3 49C * 
BUILD4 490 * 
*BUILDn * 
SYSTEM 191 395 691 391 593 
k* * 
** * 
*k* * 
** * 


Teen peeenpeemahenedcnehaabenacdemndasenDensdnupel anak onntembunndevenel susedenredeepubanantamndbemneh-naed-enselaneek onbemml-meunhenadpead-ceak omcbennbaneaderadbaceat ondeaek-ammbenedteaced 
RS See ewer reeks SSE! SRE GET COREE SE REN Sree PID OTE AAA GEN PINAY ONES MES GES SS ENS GF GENS GOUT EDT EE OE Ace GEE CER CUS OORT SAME Gea ven GEE GIETE EEA eR ARE Ee 


tnd ennanhaneesbesnguiearuch anus ascmpaumabaccathunssedvengudhsmnoch-orvedsqummdunesdapendapanteereendpessashumeuhemnadeasamtanendansariermustesusiemadmennbarnsadonaat aasne}anedpemadenandpoeend-mrenhamdsunat ageatameateowsie 
SS NS OS SD RN AS NS OD NS NN NS EE TS SS LS SY A NN ES SRD SY SS AS OG SERS Goer MED Se EOE GOMES 


* Section one - Control Options 
* DO NOT DELETE THESE CONTROL TAGS 
* DESCRIPTION 


Control File name 

Update level identifier for building AUX 
System level and version indicators 
System Language 

User exit EXEC. Called before initial 
accesses and after final access retore. 
2 paramters passed will indicate calling 
EXEC and SET-UP or CLEAN-UP. 


Disk strings to be merged at Receive 
Erase lower level TEXT decks at Receive 
Check for full text at Apply 

Check update fm regardless of $PTFPART fm 
Check composite AUX at Build 

Check Requisites at Build 


S camKaanal aneabeaseievarhempekanvadimspadasantoansathagnatibesieg th panidvenanioaned pastumapdtunmalanerlpstastrynaaiasaideenndnaash pakeanetenigdh asaniarasinguadssepeharceksanabessubvecakeunaknastantanmiveendbacnal 
PES TRY ER ORNS RES meee ie SEIT SRO ATS PER CRE ON Se SR RE ei! RS te Th TE AT SES ERE NED Se ET CATE ree Ene St HOLS EE vi Ohi OES eA RA Oe 


* Section two - Mini-Disk Assignments 
* STRING NAMES MUST START IN COLUMN 1 
* DESCRIPTION 


Build disks accessed before rest of dbase 
Disks for corrective and local service 
You may define additional LOCAL disks 
Control structure built by service EXECs 
CP service from TAPE 

You may define additional DELTA disks 

CP text, loadlist,control file,maclibs 

CP source,macro defs,and copy files 

You may define additional BASE disks 

New SYSRES for CP Nucleus Build 

New CMS system disk for AMENG HELP files 
New CMS system disk for UCENG HELP files 
New CMS system disk for nucleus etc. 

You may define additional BUILD disks 
293 193 

Disks reqd for your system environment. 
CMS database needed for MACLIBs. If 
latest MACLIBs are on a build disk, only 
that disk must appear here. 
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nit RAISER ES EE TEE 


(SRE GRAS CEEOD RED SPEND EN CE TE ETO GEA HENS OUTS AOE GENRE NEED ERD Meee CONTE AMES OATH MEL CUD PEGA AEE TERNO MEU GEN METS GENE Setei Sate EMAL MOWN! ne Nill AE ENO? RCI! SI AR LEA GENS SE MA ORR RE SY SE Se ra CRM SVEN ON IE GRO FRIED SEE AMD AE SRETED ASE MEER CARS I aPaRelY SAOIRS EE Nn eta RIP OEE 


: PRTFNC * Section three - Part type/Function List a 
'sRECSER. * Receive (Service) 

k* \ 

* TAPEFILE: EXEC TARGET * DESCRIPTION 

** . 


AXLIST | VMFRCAXL DELTAI 
PARTLST VMFRCCOM DELTA1L 
UPDT VMFRCUPD DELTA1 
TEXT VMFRCTXT DELTA] 


* Apply and Exclude lists 

* PTF Parts Lists 

* Update files for CP ASSEMBLE source 

* Text replacement modules for CP 

* Text shells created on target disk 

* Update shells created on APPLY disk 

* AUX files for updates to non-ASSEM parts 

* Update files for non-ASSEMBLE parts 

* New Source (assemble,macro,copy,$exec...) 
MACLIB VMFRCCOM DELTA1 ~* Maclibs are not replaced on the base 

* 

* 

* 

* 

* 

* 

* 

* 

* 


** 
*#* 


MACAUX VMFRCAUX DELTA1 
MACUPDT VMFRCUPD DELTAI1 
SOURCE VMFRCCOM DELTAI1 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| EXEC VMFRCCOM DELTA] Replacement parts and regenerated oN 
| parts other than maclibs, text, modules : 

| AMENG HELP files go directly to the 

| AMENG help Build disk 

| UCENG HELP files go directly to the 

| UCENG help Build disk 

| RESV *VMFRCCOM DELTAI Reserved parts 

| CPMOD VMFRCCOM BUILD4 CP modules targeted for system disk 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 


**k 


HELP VMFRCCOM BUILD2 


Kk 


HELP VMFRCUPP BUILD3 


*#*k 


PTFS VMFRCCOM DELTAI PTF numbered parts other than TXT 


:APP. * Apply Function oN 
* * : \ 


* PARTTYPE EXEC RENAME * DESCRIPTION aed 


** 


* 


TXT* VMFAPTXT TEXT Create AUX and rename appropriate update 

files to fm5 for names in loadlist. 

Other TXT parts renamed to TEXT 

For American English NLS support 

For KANJI NLS support 

For Uppercase English NLS support 

For Brazilian Portuguese NLS support 

TFR* VMFAPNLS TXTFRANC * For French NLS support | oe — 


* 
* 
* 
* 
* 
* 
* 
* 
TGR* VMFAPNLS TXTGER * For German NLS support . 
* 
* 
* 
* 
* 
* 
* 


kk 
** 


TAM* VMFAPNLS TXTAMENG 
TKA* VMFAPNLS TXTKANJI 
TUC* VMFAPNLS TXTUCENG 
TPO* VMFAPNLS TXTPORTG 


AUXXA VMFAPAUX For MACRO and EXEC AUX files 
AXA* VMFAPAUX AUXXA For MACRO and EXEC AUX files 
EXEC VMFAPCOM 
MACRO VMFAPCOM 
a 3 VMFAPCOM 
en oi VMFAPCOM 
char VMFAPCOM 


ALL PARTS ARE LISTED BY FILETYPE 
If a part type is not listed 
VMFAPCOM is called by default 
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:BLD. * Build Function 


kk 


* BUILDLST EXEC TARGET ™* DESCRIPTION 

*k* 

Create CP nucleus based on loadlist 
Target disk symbol agrees with 

disk address in HCPSYS ASSEMBLE 

on the SYSRES macro. Defaults to 
what is in HCPSYS ASSEMBLE if no 
target disk is specified. 


CPLOAD VMFBDNUC *BUILD1 


kk 
*#* 
** 
** 


t+ + F£ F HF 


** 


*k*k 


CPYSYSCP VMFBDCPY BUILD4 * Copy TEXT decks that do not become 
eas * part of a MODULE to the system disk 


** 


CPYBTHCP VMFBDCPY DELTAl * Copy TEXT decks used by UTILITY and 
* listed in the load list, CPLOAD EXEC, 
am * to the DELTA disk. VMFAPPLY only 
lie * copies the ones not listed in the 
* 


load list. 


kk 


kk 
kk 


* CPYUTLCP VMFBDCPY DELTA] 


*xk 


Copy TEXT decks used by UTILITY which 
are not listed in the load list, 
CPLOAD EXEC. This list would be used 
if you have local modifications and 
you choose not to run VMFAPPLY. Al] 


* 
* 
** * 
* 
* 
xe * TEXT decks for which you have received 
* 
* 
* 
* 
* 


**k 
**k 


service and/or have local mods would 

be copied as a result. You need to remove 
the asterisk before CPYUTLCP before 
running VMFBLD. 

Use UTILITY to build CP Utilities 


CP LE TS LS CNS AOL SO ATE RNY SEN GAL SY WI EN A EY ML ON NN CY NS SL OY A NS A ST NY SL LS SNES GS SANS SNS SY SEL ENA ME SRS NR SERS SD ON AST SE ANS RE SY ED SED SNE UNS SORE ORD OO EE ES LS NY OO ES SS A AN SHR Ga NY SO SSE 


END. * End of Parameters for CP 
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The Program Update Tape (PUT) 


| The format of each volume of the PUT is as follows: 


| © The first tape file contains the PUT DOCUMENT, the VMSERV EXEC, and the latest tested level of 
| the service EXECs (with PTF-numbered filenames). | 


| © The second tape file contains a Memo to Users for each program product service on the volume, and the 
| latest tested level of the product parameter file for each product on the tape. 


| © The remaining tape files contain service files for the program products on that volume. 
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| 


PUT 8801 <=== PUT Descriptor File 

PUT Document <=== PUT Content and Instructions 

VMSERV ~~ EXEC <=== Compatible Service EXEC 

VMFREC  EXCnnnnn <=== Latest tested level of service EXECs 

VMFBLD EXCnnnnn 

VMFAPPLY EXCnnnnn 

$LEVEL MAP <=== Inventory of service EXECs 
saacomsssssssmssssssssses= Tape Mark ==s===s==ssse==scssssmss== 

| --- Tape File 2 --- 

prodidl crltinnl <=== Program Level File 

prodid1 MEMO <=== Instructions for product 

prodid $PFnnnnn <=== Product Parameter File 

prodid2 crlitnn0 

prodiag MmEMU 

prodid3 crllnnl 

prodid3 MEMO 

prodid $PFnnnnn <=== Product Parameter File 

prodid4 crllnnl 

prodid4 MEMO 

prodid $PFnnnnn <=== Product Parameter File 
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Figure 33 (Part 1 of 3). Format of the Program Update Tape 


prodid4 crllnnl 
prodidl $PUTnnn1 <=== Product Contents Directory 
<=== (Flag byte 1 indicates new format) 
saemiassnssssssssssssss=== Tape Mark ====s==s=ss=ssssssssssss== 


COMP1 PARTIA <=== Group processed according to Part 1 
PARTIB as described in PPF in terms of process 
COMP1 PARTIC destination. 


COMP1 PARTID 


oO 
=) 
= 
me] 
— 


PART2E <=== Processed according to Part 2 in PPF 
COMP1 PART2F 
COMP1 PART2G 


‘oP ) 
on) 
= 
~~ 
— 


COMP1 PART3H <=== Processed according to Part 3 in PPF 


COMP2 PARTIA <=== Processed according to Part 4 in PPF 
COMP2 PARTI1B 


| 

| COMP2 PART2C <=== Processed according to Part 5 in PPF 
| COMP2 PART2D 

| COMP2 PARTZE 

| COMP2 PART2F 

| COMP2 PART2G 

| 
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prodid2 crllinn0 <=== Flag byte 0 indicates compatible 
prodid2 EXEC format 3 


COMP1 PARTIA <=== Group processed by product exec 
COMP1 PARTIB 3 | 


COMP1 PARTIC <=== Group processed by product exec —_— 
COMP1 PARTID ee 
COMP1 PARTIE 
COMP1 PARTIF 


| 
Bucmeuweu de tel an ecu suse wemsaeneiea sen eeuLosseseeeeb eos ecseeeeesoces sw 
| --- Definition of SP 2 Program level Filetype --- a 
CRLLNNF - C = COREQ Flag (C or 0) 
R = Release Level of product or SCP 
LL= PTF Level of Product or PLC level SCP 
NN= Total number of files (TM's) on PUT for this Product 
= 1 indicates new format, 0 indicates compatible format 
Y 


Figure 33 (Part 3 of 3). Format of the Program Update Tape 


Although the VMSERV EXEC and service EXECs for each product are still provided on the PUT tape, you 
must use the new service EXECs, VMFREC, VMFAPPLY, and VMFBLD, to receive and apply service to 
CP, CMS, GCS, and the dump viewing facility. These EXECs are loaded from the VM/XA SP product tape 
when you install the system. You can still use VMSERV to receive and apply service to other program 
products. See Chapter 9 through Chapter 17 for examples of using the new EXECs. 


IBM packages service for VM/XA SP as service level updates. Periodically, or whenever you request it, IBM 


- ships a service level update. This includes cumulative preventive maintenance since the last release of 


VM/XA SP. 


You may find that there is more than one preventive update on a program update tape. 


The specific steps for applying the service for each particular service level update are in the PUT 
documentation. Chapter 9, “Receiving Program Update Service or Corrective Service for CMS,” 
Chapter 10, “Receiving Program Update Service or Corrective Service for CP,” Step 2 of Chapter 15, 
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“Program Update Service or Corrective Service to the Dump Viewing Facility,” and Step 2 of Chapter 16, 
“Program Update Service or Corrective Service to GCS” tell you how to get this documentation. 


The Corrective Service Tape (COR) 


| The format of each volume of the COR is as follows: 


| © The first tape file contains the COR DOCUMENT and the latest tested level of the service EXECs (with 
| PTF-numbered filenames). 


| © The second tape file contains a Memo to Users for each program product service on the volume, and the 
| latest tested level of the product parameter file for each product on the tape. 


| © The remaining tape files contain service files for the program products on that volume. 


For new format products, the format of the corrective service tape is exactly the same as the format of the 


. program update tape, except that only the tape files containing parts that actually need corrective service are 
( | included. 
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Chapter 9. Receiving Program Update Service or Corrective 
Service for CMS 


This chapter describes: 


¢ How to receive service from the program update tape or corrective service tape for CMS. 


Step 1. Preparation 


Before you begin processing program update service or corrective service, you must: 
1. Establish the appropriate minidisk access order. 


Examine the SETUP EXEC, which accesses all the minidisks where the service EXECs and the product 
parameter file might be found. The SETUP EXEC reflects the minidisk access order in the IBM-supplied 
product parameter file. If you have changed the access order, copy the SETUP EXEC with another 
name and edit your new EXEC to reflect your own product parameter file. 


The SETUP EXEC does not access all the minidisks needed by the service EXECs; and your new EXEC, 
if you create one, does not have to do so. Each service EXEC will invoke VMFSETUP to create the 
access order it needs. 


The access order created by the SETUP EXEC is: 


Mode Address Function 


A 191 MAINT’s work disk 
395 


B CMS alternate LOCAL! disk 

E 691 CMS intermediate alternate LOCALI disk 
F 391 CMS current LOCAL] disk 

G 692 CMS alternate APPLY disk 

I 593 CMS alternate DELTA disk 

J 293 CMS current DELTA disk 

K 193 CMS current BASE]1 disk 

L 393 CMS current BASE2 disk 

M 490 CMS alternate BUILD1 disk 


Note: No C- or D-disk is accessed. If you have a C-disk accessed, release it. You do not need to 


release your D-disk. 
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Now run the SETUP EXEC or your equivalent EXEC: 


setup @ 


. Copy the latest version of the DMSNGP ASSEMBLE file to the 395 disk. (If there is already a copy of 


DMSNGP ASSEMBLE or DMSNGP TEXT on the 395 disk, rename it first. Z Edit the copy and make 
the following changes: 


a. Change SYSDISK = 190 to SYSDISK = 490. 
b. Change IPLADDR=190 to IPLADDR=490. 
c. Change HELP=19D to HELP =49D (or HELP=19C to HELP =49C). 


d. Change SYSNAME=CMS to SYSNAME =newname, where newname is the name you choose for 
your test system. The sample procedure in Chapter 13, “Rebuilding CMS after Applying Service,” 
uses ALTCMS. 


e. Change INSTSEG = CMSINST to INSTSEG =zewname, where newname is the name you choose for 
your test installation segment. The sample procedure in Chapter 13, “Rebuilding CMS after 
Applying Service,” uses ALTINST. 


f. Change the VERSION = and INSTID= parameters to identify your test system. 


g. Make sure that SAVESYS=NO. If SAVESYS= YES, when you IPL CMS the system will try to 
save the alternate CMS segment that you will define in Step 10 of Chapter 13, “Rebuilding CMS 
after Applying Service” in the existing CMS segment. 


These changes will cause the new CMS nucleus (with service) to be built on the 490 minidisk. (If you 
have applied service before and the nucleus you are using now is on the 490 minidisk, SYSDISK and 
IFLADDR are already 490. Change inem back io i190 so ihat ihe’*néw nucieus wiii be Duiit on the 190 
minidisk.) 


. You will probably want VMFREC to merge the alternate DELTA, APPLY, and LOCAL minidisks to 


their corresponding current disks, in accordance with the :MERGE. tag in the product parameter file. If 
for some reason you want to do it manually, or if you want to keep any disk string from ae merged, 
see Appendix G, “Controlling Disk String Merges” on page 859. 


Note: When you apply corrective service, the DELTA1 and APPLY disk strings will be redefined to be 
the same as the LOCAL] disk string in the temporary product parameter file. This redefinition is 
necessary in order for VMFREC to load files to the LOCALI disk. It is done automatically by 
the CORCMS override in the product parameter file. 


. Use the DASD DUMP Restore program to copy the current BUILD1 disk to its eaaeevontine alternate 


disk. 


ddr # 
VM/XA SYSTEM PRODUCT DASD DUMP RESTORE PROGRAM 
ENTER CARD READER ADDRESS OR CONTROL STATEMENTS. 
ENTER: 


sysprint cons This command tells DDR to send program 
ENTER: 3 messages to your console. 


input 190 devtype MNT190 @ — 190 is your current CMS system disk. devtype 
ENTER: is the device type of the DASD volume where 
190 is located. 
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output 490 devtype MNT490 
ENTER: 


copy 000 endcyl @ 


DMKDDR711R Volid Read is MNT190. Do you 
wish to continue? 

yes # 

ENTER NEXT EXTENT OR NULL LINE: 

& 


END OF COPY 
ENTER: 

= 

END OF JOB 


5. Relabel the 490 minidisk: 


access 496 t @ 
Ready; T=n.nn/n.nn hh:mm:ss 
format 490 t (label @ 


490 is your alternate CMS system disk. 
devtype is the device type of the DASD volume 
where 490 is located. 


The value for endcyl depends on the device 
type of your 190 disk: 


Device Type endcyl 


3350 73 
3375 112 
3380 71 


You have not yet changed the label of the 490 
minidisk. (You will do so in substep 5.) 


Access 490 after the system disk. You must 
use the label option. If you don’t, you will 
erase all the files on the 490 minidisk. 


ENTER LABEL: 
mt490 
Ready; T=n.nn/n.nn hh:mm:ss 


6. Repeat substeps 4 on page 436 and 5 to copy the current HELP disks (19D, 19C, 19B...) to their 
corresponding alternate disks (49D, etc.) and to relabel the alternate disks as MNT49n. Check the 
minidisk definitions in your user directory to find the appropriate value for endcyl. 


7. Determine your system default national language: 


query lang @ 
langid 


langid can be: 


Langid Language 


AMENG Mixed-case American English 
KANJI Kanji (Japan) 

UCENG Uppercase American English 
PORTG _ Brazilian Portuguese 

FRANC French 

GER German 
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If the system default national language is uppercase American English (UCENG), you must make these 
changes: 


a. Change the :NLS. tags in the product parameter file from AMENG to UCENG. 


b. Convert the following files to upper case: 


e $VMFMSG$ EXEC 
¢ $VMFMSG$ $EXEC 


xedit $vmfmsg$ {exec|$exec} @ 
uppercas * Hi 
file i 


Note: If you receive service to these files, you must copy the changes in the replacement files to your 
modified version. 


c. In the DMSNGP ASSEMBLE file, change the LANG parameter from AMENG to UCENG and the 
HELP disk address from 19D to 19C. 


| 8. If your product parameter file is on the 191 disk, you can either rename it or copy it to another disk so ( J 

| that VMFREC will not overlay it, or follow the instructions in the “Usage Notes” section of the —— 

| VMFREC EXEC description (on page 710) for instructions on how to set up a separate minidisk for the 

| Service EXECS. 

9. Rename the latest level of DMSNGP TEXT to save your old text file, then reassemble the DMSNGP 
ASSEMBLE file to include the changes you made in steps 2 on page 436 and 7 on page 437. 
vmnfhasm dmsngp 56643082 cms @ 

— 
ae 
-_ 
7 
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Step 2. Receive Service 


| Before You Receive Service 


| | If you are not familiar with the new options provided in the VMFREC EXEC with the addition of 

| | APAR VM37518, refer to “WMFREC EXEC” on page 709. In particular, the section “Usage Notes” on 
| | page 710 describes considerations for using the TASK disk string to establish a separate disk string for 

| the service execs. 


1. Establish the appropriate minidisk access order: 


setup 
2. Attach a tape drive to MAINT: 
( attach vdevno * 181 Hf 


3. Mount and ready the program update tape or corrective service tape. 


4. Map the PUT or COR tape and receive the documentation. Mapping the tape means verifying that all 
the necessary files exist. Enter: 


| VMFREC INFO (MEMOS xxx loads 

| documents to the C-disk if it is accessed, 
| otherwise to the A-disk. You want them 
| loaded to the A-disk. 


release c 


| 
| 
| 


vmfrec info (MEMOS xxx @ 
DMSREC18521I This is n of n, 
level level {PUT|COR} tape 


Ready; T=n.nn/n.nn hh:mm:ss 


xxx 1s put if you are mapping a program 
update tape, cor if you are mapping a 
corrective service tape. If the tape you 
mounted is not the kind of tape you specified, 
you receive an error message. 


VMFREC INFO (MEMOS maps the tape 
and loads the tape map, the PUT document or 
COR document, and the Memo to Users to 
your A-disk. Read these documents before 
going on. 


If your system default language is uppercase 
American English, you may get message 
DMSMGMS8I4E. This message is caused by a 
problem with the REXX date function. You 
can ignore it. 


5. VMFREC may tell you that the level of service EXECs on the tape is different than the level of service 


EXECs on your system. Refer to the “Usage Notes” section of the VMFREC EXEC description (on 
page 710) for information on receiving a new level of the service EXECs. 


¢ If you have not made any local modifications to the old product parameter file, you can use the new 


file as it stands. Go on to the next step. 
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If you had any local modifications in the old product parameter file, your override file should be on - 
the CMS LOCAL] disk string. Look at the new product parameter file‘on. the 191 disk to see if any 
changes from the last IBM-supplied product parameter file affect your override file. If you are 
applying corrective service, be sure to include the changes from the corrective service override section 
of the base file in your override file. 


The product parameter file has three sections for each component: 


a. Control options 
b. Minidisk assignments 
c. EXECs needed to update each part of the product. 


You may change the first two sections to suit your installation, but it is not recommended that you 
change the EXEC section. 


Always place changes in an override file. Do not change the base product parameter file. 


Warning: The disk addresses in the SPLOAD PROFILE, user directory, 56643082 $PPF, and 
SETUP EXEC, and the default addresses used by the ITASK EXEC must all match. If you change > 
an address in any one of these places, you must change it in all the others. We recommend that you 


fo 
do not change any addresses. | ; 
After you have made any necessary changes in your own override file, copy it to the 191 disk with 
the REPLACE option. | 
For more information about the product parameter file, see “The Product Parameter File” on page 401. 
° oe the service files to the target minidisk eyou speciness in oe Braue es file. Enter: 
vmfrec 56643082 cms (xxx xXX 1S oe for program oie service, cor for 
NMSRECIRQEDT Thic ic n anf n earrective carvice Tf you need tn invale an 
level level {PUT|COR} tape override file, sabstituce that file’s name for 
cms. No 
DMSREC1869R 56643082 CMS begins on {PUT|COR} If you do not have the correct volume 
level volume vol. Mount mounted, mount it now. 


correct volume and press ENTER 


The VMFREC EXEC loads the service files to 
or type QUIT. 


= the target minidisk. 


DMSREC1852I This is n of n, 
level level {PUT|COR} tape | 
DMSREC1804I Receiving service for i me 
component CMS of product 
56643082 
DMSREC18511 Processing parttype with the part handler 
parthandler EXEC. 


fo 
NY 


DMSREC1850I The processing for RESV by the 
VMFRCCOM EXEC was bypassed 
Ready; T=n.nn/n.nn hh:mm:ss 


| 7. Review the receive exception log (SVMFREC $ERRLOG). If necessary, correct any problems before 
| going on. | 


| vmfview receive 
| Ready; T=n.nn/n.nn hh:mm:ss 
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MAP 0006: What to Do Next 


Are you also servicing CP? 
Yes No 


— Goto Chapter 11, “Applying Program Update Service or Corrective Service to CMS” on page 449. 


003 


Have you received service for CP? 
Yes No 


( 


— Go to Chapter 10, “Receiving Program Update Service or Corrective Service for CP” on page 443. 


— Go to Chapter 11, “Applying Program Update Service or Corrective Service to CMS” on page 449. 
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~? 


Chapter 10. Receiving Program Update Service or Corrective 


Service for CP 


This chapter describes: 


¢ How to receive service from the program update tape or corrective service tape for CP. 


Step 1. Preparation 


Before you begin processing program update service or corrective service, you must: 


1. Establish the appropriate minidisk access order. If you have not yet examined the SETUP EXEC, and 
created your own version if necessary, turn to page 435 and do so now. Then issue: 


setup 


2. You will probably want VMFREC to merge the alternate DELTA, APPLY, and LOCAL minidisks to 
their corresponding current disks, in accordance with the :MERGE. tag in the product parameter file. If 
for some reason you want to do it manually, or if you want to keep any disk string from being merged, 


see Appendix G, “Controlling Disk String Merges” on page 859. 


Note: When you apply corrective service, the DELTA1 and APPLY disk strings will be redefined to be 
the same as the LOCAL] disk string in the temporary product parameter file. This redefinition is 
necessary in order for VMFREC to load files to the LOCALI disk. It is done automatically by 


the CORCP override in the product parameter file. 


3. Determine your system default national language: 


query lang @ langid can be: 

pangue Langid Language 
AMENG Miixed-case American English 
KANJI Kanji (Japan) 
UCENG Uppercase American English 
PORTG _ Brazilian Portuguese 
FRANC French 
GER German 


If the system default national language is uppercase American English (UCENG), you must make these 


changes: 


a. Change the :NLS. tags in the product parameter file from AMENG to UCENG. 


b. Convert the following files to upper case: 


¢ $VMFMSG$ EXEC 
¢ $VMFMSG$ $EXEC 


xedit $vmfmsg$ {EXEC|$EXEC} 
uppercas * @ 
file & 
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Note: If you receive service to these files, you must copy the changes i in | the replacement files to ou 
modified version. 


4. If your product parameter file is on the 191 disk, you can rename it or copy it to another disk so that 
VMFREC will not overlay it, or you can follow the instructions in the “Usage Notes” section of the 
VMFREC EXEC description (on page 710) for instructions on how to set up a separate minidisk for the 
service EXECs. : 
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Fete, eh Tce Nn a ee ee ee ee ee. 


Step 2. Receive Service 


Before You Receive Service 


If you are not familiar with the new options provided in the VMFREC EXEC with the addition of 
APAR VM37518, refer to “VMFREC EXEC” on page 709. In particular, the section “Usage Notes” on 
page 710 describes considerations for using the TASK disk string to establish a separate disk string for 
the service EXECs. 


1. Establish the appropriate minidisk access order: 
setup @ 

2. Attach a tape drive to MAINT: 
attach vdevno * 181 & 


3. Mount and ready the program update tape or corrective service tape. 


4. Map the PUT or COR tape and receive the documentation. Mapping the tape means verifying that all 
the necessary files exist. Enter: 


release c @ VMFREC INFO (MEMOS xxx loads 
documents to the C-disk if it is accessed, 
otherwise to the A-disk. You want them 
loaded to the A-disk. 


vnfrec info (memos xxx Mf xxx is put if you are mapping a program 
DMSREC1852I This is n of n, update tape, cor if you are mapping a 
level level {PUT|COR} tape corrective service tape. If the tape you 


mounted is not the kind of tape you specified, 
you receive an error message. 


VMFREC INFO (MEMOS maps the tape and 
loads the tape map, the PUT document or 
COR document, and the Memo to Users to 
your A-disk. Read these documents before 
going on. 


If your system default language is uppercase 
American English, you may get message 
DMSMGMS814E. This message is caused by a 
problem with the REXX date function. You 
can ignore it. 


Ready; T=n.nn/n.nn hh:mm:ss 


5. VMFREC may tell you that the level of service EXECs on the tape is different than the level of service 
EXECs on your system. Refer to the “Usage Notes” section of the VMFREC EXEC description (on 
page 710) for information on receiving a new level of the service EXECs. 


e If you have not made any local modifications to the old product parameter file, you can use the new 
file as it stands. Go on to the next step. 
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¢ If you have any local modifications in the old product parameter file, your override file should be on 
the CMS LOCAL] disk string. Look at the new product parameter file on the 191 disk to see if any 
changes from the last IBM-supplied product parameter file affect your override file. If you are 
applying corrective service, be sure to include the changes from the corrective service override section 
of the base file in your override file. 


The product parameter file has three sections for each component: 


a. Control options 
b. Minidisk assignments 
c. EXECs needed to update each part of the product. 


You may change the first two sections to suit your installation, but it is not recommended that you 
change the EXEC section. 


Always place changes in an override file. Do not change the base product parameter file. 


Warning: The disk addresses in the SPLOAD PROFILE, user directory, 56643082 $PPF, and 
SETUP EXEC, and the default addresses used by the ITASK EXEC must all match. If you change 
an address in any one of these places, you must change it in all the others. We recommend that you 
do not change any addresses. 


After you have made any necessary changes in your own override file, copy it to the 191 disk with 
the REPLACE option. 


For more information about the product parameter file, see “The Product Parameter File” on page 401. 


6. Receive the service files to the target minidisk you specified in the product parameter file. Enter: 


vmfrec 56643082 cp (xxx Hf xxx is put for program update service, cor for 
NMSRECISEZT This is n of n, corrective service. If van need to invoke an 
level level {PUT|COR} tape override file, substitute that file’s name for ep. 
DMSREC1869R 56643082 CP begins on {PUT|COR} If you do not have the correct volume 
level volume vol. Mount mounted, mount it now. 
eorecet vouumle eng ences al The VMFREC EXEC loads the service files to 


5 ap Pe eae the target minidisk. 
DMSREC1852I This is n of n, 

level level {PUT|COR} tape 
DMSREC1804I Receiving service for 

component CP of product 

56643082 
DMSREC1851I Processing parttype with part handler 


parthandler EXEC. 
Ready; T=n.nn/n.nn hh:mm:ss 


7. Review the receive exception log (SVMFREC $ERRLOG). If necessary, correct any problems before 
going on. 


vnfview receive Mf 
Ready; T=n.nn/n.nn hh:mm:ss 
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MAP 0007: What to Do Next 
001 


Are you also servicing CMS? 
Yes No 


— Go to Chapter 12, “Applying Program Update Service or Corrective Service to CP” on page 453. 
003 


Have you received service for CMS? 
Yes No 


— Go to Chapter 9, “Receiving Program Update Service or Corrective Service for CMS” on page 435. 


— Go to Chapter 11, “Applying Program Update Service or Corrective Service to CMS” on page 449. 
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Chapter 11. Applying Program Update Service or Corrective 
Service to CMS 


This chapter describes: 


¢ How to apply service from the program update tape or corrective service tape to CMS. 


Warning: If you are servicing both CP and CMS, you must receive both CP and CMS service before 
applying service to CMS, because you need CP macro libraries to apply service to CMS. Some of these 
libraries may have been serviced. 


(_ MAP 0008: Should You Be Doing This Now? 
001 


Are you also servicing CP? 


Yes No 
002 
( ; — Continue with this chapter. 
003 
Have you run VMFREC to receive service for CP? 
Yes No 
( — Go to Chapter 10, “Receiving Program Update Service or Corrective Service for CP” on page 443. 


— Continue with this chapter. 
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. Consult your IBM service representative for the appropriate preventive service planning (PSP) bucket for 
your system’s VMSUP level and PUT level. Check the bucket and add the appropriate entries to the 
exclude list. (The exclude list is called fn SEC where ike is the filename of the control file defined 
for CMS in the product parameter file.) 


Note: If two PTFs are in the same text deck, you cannot exclude the first unless you also exclude the 
second, even if you list the first one on the exclude list. This restriction applies because the first 
PTF is considered to be a prereqisite for the second PTF. 


If you list the first PTF in the exclude list, but not the second, and if the second PTF appears in 
the apply list, both PTFs will be applied. You will receive an error message indicating that a PTF 
you wanted to exclude has been applied. 


. Establish the appropriate minidisk access order: 
setup @ 
. Apply the service, that is, create auxiliary control files. Enter: 


vnfapply 56643082 cms (xxx 
DMSAPP1853I Processing PTF ptfnum 


xxx is put if you are applying program update 
service, cor if you are applying corrective 

: service. 
Ready; T=n.nn/n.nn hh:mm:ss | 


The VMFAPPLY EXEC creates or edits the necessary control files and, if appropriate, calls the 
VMFAPNLS EXEC to create auxiliary control files for national language support (see “WMFAPNLS 
EXEC” on page 676). 


. Review the apply exception log (SVMFAPP $ERRLOG). If necessary, correct any problems before 
going on. 

vmfview apply Mf 
If you receive message number DMSAPP1885W, VMFAPPLY has applied service to a module for which 
you have a local modification. Decide what you want to do with the local modification: 


¢ To remove a local modification, see Chapter 18, “Receiving and Applying Local Service” on 
page 565, and Chapter 20, “Removing Service from VM/XA SP” on page 581. 


¢ To rework a local modification, see Chapter 18, “Receiving and Applying Local Service” on 
page 565. 


¢ To keep a local modification, do nothing now. You will reassemble the module to pick up the local 
modification in Step 4 of Chapter 13, “Rebuilding CMS after Applying Service.” 


Whether you remove, rework, or keep local modifications, you do not have to reissue VMFAPPLY. 

Do not erase $VMFAPP $ERRLOG. 

. Check to see if you have applied service to DMSZIT ASSEMBLE: 

filelist dmszit * fm5 @ The updates are on the alternate LOCALI 
(395) disk if you are applying corrective 


service, the alternate DELTA (593) disk if you 
are applying program update service. 


A filemode of 5 indicates that service has been 
applied. 
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If any update files are listed, or if you know that you have applied a local update to DMSZIT 
ASSEMBLE, copy the latest level of the text deck to the 395 disk, giving the copy the filetype TEXT: 


copy dmszit txtxxxxx fm = text b Mf The text deck is on the alternate LOCALI 
(395) disk if you are applying corrective 
service, the alternate DELTA (593) disk if you 
are applying program update service. 


MAP 0009: What to Do Next 


Are you also servicing CP? 
Yes No 


( — Go to Chapter 13, “Rebuilding CMS after Applying Service” on page 457. 


003 


—- Go to Chapter 12, “Applying Program Update Service or Corrective Service to CP” on page 453. 
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Chapter 12. Applying Program Update Service or Corrective 
Service to CP 


This chapter describes: 


¢ How to apply service from the program update tape or corrective service tape to CP. 


MAP 0010: Should You Be Doing This Now? 


Are you also servicing CMS? 
Yes No 


— Continue with this chapter. 
003 


Have you run VMFAPPLY to apply service to CMS? 
Yes No 


— Go to Chapter 11, “Applying Program Update Service or Corrective Service to CMS” on page 449. 


— Continue with this chapter. 
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. Consult your IBM service representative for the appropriate preventive service planning (PSP) bucket for 


your system’s VMSUP level and PUT level. Check the bucket and add the appropriate entries to the 
exclude list. (The exclude list is called fn $EXCLIST, where fn is the filename of the control file defined 
for CP in the product parameter file.) 


Note: If two PTFs are in the same text deck, you cannot exclude the first unless you also exclude the 
second, even if you list the first one on the exclude list. This restriction applies because the first 
PTF is considered to be a prereqisite for the second PTF. 


If you list the first PTF in the exclude list, but not the second, and if the second PTF appears in 
the apply list, both PTFs will be applied. You will receive an error message indicating that a PTF 
you wanted to exclude has been applied. 


. Establish the proper minidisk access order: 


setup @ 


. Apply the service, that is, create auxiliary control files. Enter: 


vnfapply 56643082 cp (xxx xxx is put for program update service, cor for 
DMSAPP1853I Processing PTF ptfnum corrective service. 


Ready; T=n.nn/n.nn hh:mm:ss 


The VMFAPPLY EXEC creates or edits the necessary control files and calls the appropriate 
part-processing EXECs: VMFAPTXT, VMFAPNLS, etc. 


. Review the apply exception log (SVMFAPP $ERRLOG). If necessary, correct any problems before 


going on. 
vmfview apply @ 
If you receive message number DMSAPP1885W, VMFAPPLY has applied service to a module for which 


you have a local modification. Decide what you want to do with the local modification: 


¢ To remove a local modification, see Chapter 18, “Receiving and Applying Local Service” on 
page 565, and Chapter 20, “Removing Service from VM/XA SP” on page 581. 


e To rework a local modification, see Chapter 18, “Receiving and Applying Local Service” on 
page 565. 


¢ To keep a local modification, do nothing now. You will reassemble the module to pick up the local 
modification in Step 4 of Chapter 14, “Rebuilding CP after Applying Service.” 


Whether you remove, rework, or keep local modifications, you do not have to reissue VMFAPPLY. 


Do not erase $VMFAPP $ERRLOG. 
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MAP 0011: What to Do Next 
001 


Are you also servicing CMS? 
Yes No 


002 


— Go to Chapter 14, “Rebuilding CP after Applying Service” on page 515. 


003 


— Go to Chapter 13, “Rebuilding CMS after Applying Service” on page 457. 
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Chapter 13. Rebuilding CMS after Applying Service 


This chapter describes: 


e A step-by-step procedure for rebuilding CMS after applying program update service, corrective 
service, or local service. 


MAP 0012: Should You Be Doing This Now? 
001 


Are you also servicing CP? 
Yes No 


002 
— Continue with this chapter. 
003 


Have you run VMFAPPLY to apply service to CP? 
Yes No 


— Go to Chapter 12, “Applying Program Update Service or Corrective Service to CP” on page 453. 


— Continue with this chapter. 
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Step 1. Build a New CMS Macro Library 


1. Establish the appropriate minidisk access order: 


setup 
vmfsetup 56643082 cms (bid 


ee Program Update Service Only OE 


2. If you are processing program update service, erase CMSNEW MACLIB if it exists. Do not erase 
CMSNEW MACTLIB if you are processing corrective service or local service. | 


erase cmsnew maclib fm Hi 
Ready; T=n.nn/n.nn hh:mm:ss 


ee ae End of Program Update Service Only ene ees 


Do the rest of this step if: 


e You are processing program update service and have local modifications to 
CMS macros or control blocks 

¢ You are processing corrective service 

¢ You are processing local service. 


3. Access 395 as A: 
access 395 a & 


4. Find out which macros and control blocks have been updated by IBM: 


listfile * T*DS fm (exec @ The updates you have just received are on the 
rename cms exec a cmsmcfix = = @ | alternate LOCALI1 (395) disk if you are 
xedit cmsmcfix exec applying corrective service, the alternate 

sort * 150 @ DELTA (593) disk if you are applying 

file @ program update service. You may also have 


updates on other disks in the LOCAL] string. 


The exee option saves the list in a file called 
CMS EXEC. Any previously existing CMS 
EXEC on your A-disk is erased. 


5. Find out which disk the source files for macros and control blocks are on. They should be on the CMS 
BASE2 disk (393). 


listfile * macro * 
Ready; T=n.nn/n.nn hh:mm:ss 
listfile * copy * @ 
Ready; T=n.nn/n.nn hh:mm:ss 
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. 


6. Create or edit an EXEC to generate a macro library for updated macros called CMSNEW EXEC. It 
should have the same format as DMSSP EXEC, and should list: | 


e For program update service, only those macros and control blocks for which you have received 
service and for which you also have local modifications 


e For corrective service, all macros and control blocks for which you have received service, plus any 
for which you have local modifications 


¢ For local service, all macros and control blocks for which you have local modifications. 


If you have no macros or control block files that must be listed in CMSNEW EXEC, go to substep 11 on 
page 460. 


a. If you have not already created CMSNEW EXEC, issue: 

copy dmssp exec fm cmsnew = a (recfm f Irecl 80 

b. If you already have a copy of CMSNEW EXEC, issue: 

copy cmsnew exec fm = = a (recfm f Irecl 80 @ 
Now edit CMSNEW EXEC, adding all necessary macro and control block names. If you created 
CMSNEW EXEC by copying DMSSP EXEC, use the contents of DMSSP EXEC only for a guide to the 
format of the macro entries. After you have added the macro and control block names you need, in the 
proper format, delete the macro names that came from DMSSP EXEC. 

xedit cmsnew exec a Mf 

file @ 
. You now need to copy every macro and control block file listed in CMSNEW EXEC to your A-disk. 


copy fn macro fm = = a (olddate replace @ 
copy fn copy fm = = a (olddate replace @ 


. Generate the new macro library by using the VMFMAC EXEC: 


vmfmac cmsnew dmsmxa DMSMXA CNTRL is a special control file 
DMSUPD178I Updating macroname MACRO Al used for generating CMS macro libraries. Do 
DMSUPD178I Applying macroname update Al not confuse it with DMSXA CNTRL, the 
macroname MACRO ADDED CMS main control file. 


Ready; T=n.nn/n.nn hh:mm:ss 


Note: An alternate method to using the VMFMAC EXEC is to update the control blocks and macros 
by using the UPDATE module, issuing MACLIB DELETE and then MACLIB ADD commands 
for the MACLIB containing the changed macro or control block. 


See VM/XA SP CMS Command Reference for details on the MACLIB command. 


. The new macro library is now on your A-disk (395). You can now erase CMSNEW COPY (a file 
created by VMFMAC) from the 395 disk. 


erase cmsnew copy a @ 
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10. Add the new macro library name to the TEXT MACS card in the DMSXA CNTRL file. (DMSXA 
CNTRL is the the CMS main control file. Do not confuse it with DMSMXA CNTRL, used for 
generating CMS macro libraries.) | 


Make the new macro library the first one listed so that you use the updated macros. 


xedit dmsxa cntr] @ 
locate/TEXT MACS @ 

TEXT MACS maclib ... 
change/MACS/MACS CMSNEW/ @ 
TEXT MACS CMSNEW maclib ... 
file Mi 


11. Access 395 as B and 191 as A: 


access 395 b @ 
access 191 a @ 
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Step 2. Build a New CP Macro Library 


¢ 1. Establish the appropriate minidisk access order: 


setup & 


Ready; T=n.nn/n.nn hh:mm:ss 
vnfsetup 56643082 cp (bld @ 
DMSWSU1900W The existing 56643082 $SETUP Al file 


has been refreshed. You might want to 
check your access order when done. 


Ready (0004); T=n.nn/n.nn hh:mm:ss 


| Program Update Service Only | 


2. If you are processing program update service, erase CPNEW MACLIB if it exists. Do not erase CPNEW 
MACLIB if you are processing corrective service or local service. 


( erase cpnew ma 


clib fm @ 


Ready; T=n.nn/n.nn hh:mm:ss 


Fee End of Program Update Service Only Sea a eae 


Do the rest of this step if: 


3. Access 295 as A: 


¢ You are also servicing CP, and 


¢ One of these conditions applies: 


You are processing program update service and have local modifications 
to CP macros or control blocks 

You are processing corrective service 

You are processing local service. 


( | access 295 a @ 
4. Find out which macros and control blocks have been updated by IBM. First list all the CP updates you 
received from IBM: 

listfile * H*HP fm (exec The updates are on the CP alternate LOCAL] 
rename cms exec a cpupdate = = (295) disk if you are applying corrective 
xedit cpupdate exec service, or on the CP alternate DELTA (594) 
sort * 150 @ disk if you are applying program update 
file @ service. You may also have updates on other 


disks in the LOCAL] string. 


The exec option saves the list in a file called 
CMS EXEC. Any previously existing CMS 
EXEC on your A-disk is erased. 
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Eat 2 ' 


5. Find which of the updates you received affect macros and control blocks. At the same time, note where 
those macros and control blocks are. The source files for macros and control blocks should be on the CP 
BASE2 disk (394). For each update listed in CPUPDATE EXEC, issue: 


listfile fn macro * @ | If the update affects a macro or control block 
Ready; T=n.nn/n.nn hh:mm:ss file, that file will be listed. 

listfile fn copy * @ 

Ready; T=n.nn/n.nn hh:mm:ss 


6. Create or edit an EXEC called CPNEW EXEC to generate a library for updated macros. It should have 
the same format as HCPXA1 EXEC, and should list: 


¢ For program update service, only those macros and control blocks for which you have received 
service and for which you also have local modifications 


¢ For corrective service, all macros and control blocks for which you have received service, plus any 
for which you have local modifications 7 | 


¢ For local service, all macros and control blocks for which you have local modifications. 


If you have no macros or control block files that must be listed in CPNEW EXEC, go to substep 11 on . 
page 463. 


a. If you have not already created CPNEW EXEC, issue: 
copy hcpxal exec fm cpnew = a (recfm f Irec] 80 @ 
b. If you already have a copy of CPNEW EXEC, issue: 
copy cpnew exec jm = = a (rectmT ireci 80 m@ a 
Now edit CPNEW EXEC, adding all necessary macro and control block names. If you created CPNEW 
EXEC by copying HCPXA1 EXEC, use the contents of HCPXA1 EXEC only for a guide to the format 
of the macro entries. After you have added the macros and control block names you need, in the proper 
format, delete the macro names that came from HCPXAI EXEC. 


xedit cpnew exec a @ 


file Hf 


7. You now need to copy every macro and control block file listed in CPNEW EXEC to your A-disk. ‘a / 


a 


copy fn macro fm = = a (olddate replace @ 
copy fn copy fm = = a (olddate replace @ 


8. Generate the new macro library by using the VMFMAC EXEC: 


vmnfmac cpnew hcpxa 
DMSUPD178I Updating macroname MACRO Al 
DMSUPD178I Applying macroname update Al 
macroname MACRO ADDED 


Ready; T=n.nn/n.nn hh:mm:ss 
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Note: An alternate method to using the VMFMAC EXEC is to update the control blocks and macros 
by using the UPDATE module, and issuing MACLIB DELETE and then MACLIB ADD 
commands for the MACLIB containing the changed macro or control block. 


See VM/XA SP CMS Command Reference for details on the MACLIB command. 


9. The new macro library is now on your A-disk (295). You can now erase CPNEW COPY (a file created 
by VMFMAC) from the 295 disk. 


erase cpnew copy a & 


10. Add the new macro library name to the TEXT MACS card in the HCPXA CNTRL file. Make it the 
first macro library listed so that you use the updated macros. 


xedit hcpxa cntr] 
locate/TEXT MACS @ 
TEXT MACS HCPXA1 ... 
: change/MACS/MACS CPNEW/ 
( * TEXT MACS CPNEW HCPXA1 ... 
, file Hi 


11. Reaccess 295 as B and 191 as A: 


access 295 b 
access 191 a 
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Step 3. Update the CMS Message Repository 


Do this step if: 


e You are processing program update service and have local modifications to. 
the CMS message repository 

e You are processing corrective service and have local modifications to the 
CMS message repository 

e You are processing local service. 


1. Determine your system default national language: 
query lang @ 
langid See Table 5 on page 317 to identify the 
language corresponding to langid. Note the 
country code for that language. 


2. Invoke the VMFNLS EXEC to update the CMS message repository: 


vmfnis dmsmesy repos 56643082 cms Mi y is the country code for your system national 
Ready; T=n.nn/n.nn hh:mm:ss language. 


3. If vou have undates to the message repositories for anv other national languages installed on your 
system, repeat substep 2 for each language. 
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Step 4. Assemble the Changed ASSEMBLE Files 


Do this step if: 


e You are processing program update service and have local modifications to 


ASSEMBLE files 
¢ You are processing corrective service 
e You are processing local service. 


1. Establish the appropriate minidisk access order: 


setup # 


| 2. Review the apply exception log (SVMFAPP $ERRLOG) for the names of ASSEMBLE files to which 
| you have applied service and for which you also have local updates. Chapter 11, “Applying Program 
dae | Update Service or Corrective Service to CMS” on page 449 has instructions for deciding which of these 
( | local updates you wish to keep. 


| vmfview apply B To find these ASSEMBLE files, search for all 
| instances of message DMSxxx1885W. This 

| message lists all the MACRO, COPY, EXEC, 
| XEDIT, and ASSEMBLE files for which you 
| have local updates. You must reassemble any 
| such ASSEMBLE files to pick up the local 

| updates. 


If you have applied IBM service to any ASSEMBLE files for which you have 


local updates, and you wish to keep the local updates, continue with substep 3. 
Otherwise, go to “Step 5. Build the Nucleus” on page 467. 


3. Copy the ASSEMBLE files you need to reassemble from the 393 disk to your A-disk: 


copy dmsxxx assemble ] = = a (unpack olddate @ Substitute the last 3 letters of the filename of 
( Ready; T=n.nn/n.nn hh:mm:ss the ASSEMBLE file for xxx. 
Re 4. Use the VMFHASM EXEC to update and assemble all the files for which you have both IBM service 


and local modifications: 
” 
vmfhasm dmsxxx 56643082 cms Substitute the last 3 letters of the filename of 
the ASSEMBLE file for xxx. 


DMSUPD178I UPDATING DMSxxx ASSEMBLE filemode 

DMSUPD178I APPLYING DMSxxx filetype filemode 

ASSEMBLING DMSxxx 

DMSxxx {TEXT|xxxnnnnn} CREATED 

PRT FILE nnnn SENT FROM MAINT PRT AS nnnn 
RECS nnnn COPY 001 I NOHOLD NOKEEP 

Ready; T=n.nn/n.nn hh:mm:ss 
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5. Copy all the text files from the A-disk to the alternate LOCAL! (395) disk: 
copy dmsxxx {text|xxxnnnnn} a==b | 


6. If you reassemble any files that are not in the CMS load list, copy the text decks to the alternate 
LOCAL] disk again, giving the copy the filetype TEXT: 


copy dmsxxx {text|xxxnnnnn} a = text b Hf 
7. Erase all the ASSEMBLE files and text files from your A-disk: 


erase dmsxxx assemble a 
erase dmsxxx {text|xxxnnnnn} a 


8. Make sure that you perform substeps 3 on page 465 through 7 for each file that must be reassembled. 
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Step 5. Build the Nucleus 


1. Establish the appropriate minidisk access order: 
setup @ 
2. Generate the new CMS nucleus: 


spool punch * class n @ 
spool prt * @ 
spool rdr class n 


| vmfbld 56643082 cms (punch If you are processing PUT service, use cms as 


| a the component name. 


If you are processing COR service, use corcms 


| vmfb1d 56643082 corcms (punch @ 
as the component name. 


DMSBLD1851I Processing CMSLOAD with 
| the part handler VMFBDNUC EXEC (To ensure that text decks are copied to the 
| LOAD LIST: $$$TLL$$ EXEC Al (MNT191) correct disk during VMFBLD execution using 
| VMFBDCPY, the component name for CMS 
| corrective service is now corcms. This causes 
| . the corrective service override to be applied to 
| the 56643082 $PPF and the DELTA disk 
| string to be redefined). 


This invokes the VMFBLD EXEC to build a 
new nucleus for CMS. The VMFBLD EXEC 
performs a number of system generation 
functions for you. For more information on 
this EXEC, see “VMFBLD EXEC” on 


page 679. 
RDR FILE fileno SENT FROM MAINT PUN AS fileno The system loader punches the CMS nucleus. 
RECS nnnn COPY 001 N NOHOLD NOKEEP This message tells you that the punch file is 
complete. 
Ready; T=n.nn/n.nn hh:mm:ss If you get return code 4, the reason may be 


that a PTF which is now being applied has 
another PTF, outside CMS, as a prerequisite. 
Check the $VMFBLD $ERRLOG file for 
message DMSBNC1854W. 


| 3. Review the build exception log (SVMFBLD $ERRLOG). If necessary, correct any problems before 
| going on. | 


| vnfview build @ 
4. IPL your virtual reader: 


ip] 00c 
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DMSINS327I The installation saved segment could not be loaded. 


Informational message. The CMSINST 
‘installation segment has not been loaded and 


saved yet. 
VM/XA ALTCMS mm/dd/yy The version identification you defined appears 
| here and each time that you IPL 490 or IPL 
SYNONYM SYN CMS. 
CP TERM MODE VM 
" Ready; T=n.nn/n.nn hh:mm:ss The ready message indicates that the nucleus 
has been loaded to your 490 minidisk 
successfully. 
5. Query the reader to identify the CMS load map: —_, 
ee , 
query rdr * all @ 
: ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 
| MAINT fileno M PUN nannnnnn 001 NONE mm/dd hh:mm:ss SYSPROG 
The CMS load map is the file with a blank 
filename and filetvne It has annroximately 7 
8100 records. The exact size varies according a . 
to the system default language, local 
modifications, and VMSUP level. Note the 
fileno of this file. You will use it in your next 
command. 
6. Receive the CMS load map that is in your reader. 
spool prt * nohold @ 
close prt * & ie 
at 
setup @ The CMS load map its loaded onto the CMS 
receive fileno cmsnuc map b (replace @ LOCAL] (0395) minidisk. 


| CMSNUC MAP B1 created 
| DMSRDC738I Record length is 132 bytes 
| File CMSNUC MAP B received from MAINT at 
nodeid as CMSNUC MAP B 
Ready; T=n.nn/n.nn hh:mm:ss 


7. Review the CMS load map to verify that any local modifications to CMS modules have been applied. 


Warning: From this point on, use IPL 490 instead of IPL 190 whenever you 


need to re-IPL CMS. The alternate (test) nucleus is on the 490 disk; the 
current (production) nucleus is on the 190 disk. 
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Do this step if: 


You are processing program update service and have local modifications to 
executable modules 

You are processing corrective service 

You are processing local service. 


1. Establish the appropriate minidisk access order: 


setup 
vmfsetup 56643082 cms (bld 


2. Determine if you need to generate any executable modules. 


¢ If you are processing corrective service, make and sort a list of the files you are servicing: 


listfile dms* text b (exec label @ The exec option saves the list in a file called 
rename cms exec a dmstext = = &@ CMS EXEC. Any previously existing CMS 
xedit dmstext exec Ml | EXEC on your A-disk is erased. 

sort * 150 @ 

file @ 


Check the whole list against Table 12. You must generate an executable module for any file you 
find listed there. 


e If you are processing program update service, review the apply exception log for files that have both 
IBM service and local modifications. 


vmfview apply @ To find these files, search the exception log for 
those messages that have message prefix BD: 
and message number DMSxxx1885W. Check 
these files against Table 12. You must 
generate an executable module for any file you 
find listed there. 


3. Find each executable module you have to regenerate in the first column of the table. Type the command 
in the second column. Make sure that the file named in the third column is created. You can ignore any 
“INVALID CARD” messages you receive while running CMSGEND. 


During regeneration of the modules in Table 12, files with a filetype of LKEDIT may be created and 
erased. You do not need them. 


Table 12 (Page 1 of 5). CMSGEND Files 


Assemble File 
Name Command to Type In File Created by this Command 


Note: If you receive service for a CMS text deck not listed in this table, it will be regenerated in 


some other way. You do not need to regenerate it now. (See Table 15 on page 589 in 
Appendix A, “VM/XA System Product Regeneration Requirements” for the procedure used. 
Text decks not listed in this table or in Table 15 on page 589 become part of the nucleus 
when the system is built if they are listed in the CMS load list.) 


DMSAMS cmsgend amservy @ AMSERV MODULE 
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Table 12 (Page 2 of 5). CMSGEND Files | 


Assemble File : | 
Name Command to Type In 


DMSASD, cmsgend assemble & 
DMSASM 


DMSASN cmsgend assgn ASSGN MODULE 


DMSBCT, cmsgend dmsdft & DMSDFT MODULE 
DMSBLG, 

DMSCDI, 

DMSDFT, 

DMSSMG, 

DMSUSR 


DMSBOF, 
DMSBUS, 
DMSCCM, 
DMSCIA, 
DMSICT, 
DMSPBS, 
DMSSAP, 
DMSSUP, 
DMSTRC 


DMSBTB CMSBATCH MODULE 
DMSCCK emsgend catcheck @ CATCHECK MODULE 


DMSCMP cmsgend compare @ COMPARE MODULE 


DMSDLK cmsgend dosiked & DOSLKED MODULE 
DMSDSK cmsgend disk Hi DISK MODULE 


File Created by this Command 
| ASSEMBLE MODULE 


cmsgend dmscut oe DMSCUT MODULE 


cmsgend cmsbatch @ 


DMSDSL cmsgend doslib @ DOSLIB MODULE 
DMSDSV cmsgend dserv @ DSERV MODULE 
DMSEDC, cmsgend edit @ EDIT MODULE (see Note 1 
DMSEDF, on page 473) 
DMSEDI, 

DMSEDX, 

DMSGIO, 

DMSSCR, 

DMSZIT 

DMSEXG cmsgend dcssgen @ DCSSGEN MODULE 
DMSEXM cmsgend execmap Ml EXECMAP MODULE 
DMSFOR cmsgend format @ FORMAT MODULE 
DMSGLB cmsgend global & GLOBAL MODULE 
DMSGND cmsgend gendirt @ GENDIRT MODULE 


DMSHLB, cmsgend helpconvy @ HELPCONV MODULE 
DMSHLD, 
DMSHLI, 


DMSHLP, 
DMSHLS 
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Table 12 (Page 3 of 5). CMSGEND Files 


- Assemble File , 
eo Name Command to Type In File Created by this Command 


DMSICP, cmsgend iocp @ IOCP MODULE 
IOPCxxxx, 
IOPPxxxx 
DMSIMA cmsgend imagemod IMAGEMOD MODULE 
DMSLBD cmsgend labeldef @ LABELDEF MODULE 
DMSLBM cmsgend maclib Hf MACLIB MODULE 
DMSLBT cmsgend txtlib TXTLIB MODULE 
DMSLDS cmsgend listds @ LISTDS MODULE 
DMSLLU cmsgend listio LISTIO MODULE 
m4 DMSLMX cmsgend tape Hf TAPE MODULE (see Note 2 
( | on page 473) 
DMSMDP cmsgend modmap Mf MODMAP MODULE 
DMSMGC, cmsgend genmsg GENMSG MODULE 
DMSMGD, 
DMSMGE 
DMSMVE cmsgend movefile # MOVEFILE MODULE 
; DMSNXD cmsgend nucxdrop NUCXDROP MODULE 
( ‘ DMSOPT cmsgend option OPTION MODULE 
- DMSOSR cmsgend osrun &@ OSRUN MODULE 
DMSOVR cmsgend svctrace Hf SVCTRACE MODULE 
DMSOVS cmsgend dmsovs @ DMSOVS MODULE 
DMSPCA, cmsgend dmspcc @ DMSPCC MODULE 
DMSPCB, 
DMSPCC, 
pm, DMSPCR, 
( DMSPCT, 
DMSPCW 
DMSPOA, cmsgend prop & PROPLIB LOADLIB (see Note 
DMSPOC, 3 on page 473) 
DMSPOD, 
DMSPOE, 
DMSPOL, 
DMSPON, 
DMSPOP, 
DMSPOQ, 
DMSPOR, 
DMSPOS 
DMSPRE cmsgend preload & PRELOAD MODULE 
DMSPRV cmsgend pserv & PSERV MODULE 
DMSPUN cmsgend punch @ PUNCH MODULE 
DMSRDC cmsgend readcard @ READCARD MODULE 
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Table 12 (Page 4 of 5). CMSGEND Files | ; 7 


Assemble File 


Name | Command to Type In | File Created by this Command 
DMSRDR cmsgend rdr @ ~ RDR MODULE 
DMSRNE cmsgend renum @ ~ RENUM MODULE 
| DMSRRV cmsgend rserv & RSERV MODULE 
DMSRSV cmsgend reserve @ RESERVE MODULE 
DMSSFD ~~ _—_emsgend savefd @ SAVEFD MODULE ~ 
DMSSNC cmsgend dmssnc | DMSSNC MODULE 
DMSSPR cmsgend setprt Ml SETPRT MODULE 
DMSSRT cmsgend sort # SORT MODULE 
DMSSRV _emsgend sserv SSERV MODULE | 
eo “2S 
DMSSSK cmsgend setkey @ SETKEY MODULE 2 y 
-DMSSYN cmsgend synonym @ SYNONYM MODULE 
DMSTMA cmsgend tapemac Hf TAPEMAC MODULE 
DMSTPD cmsgend tappds @ TAPPDS MODULE 
DMSTPE cmsgend tape TAPE MODULE (see Note 2 
DMSTPF, on page 473) 
DMSTPG, 
DMSTPH, ) jos 
DMSTPI, ~ wy 
DMSTP3J, 
DMSTYP cmsgend type & TYPE MODULE 
DMSUPD cmsgend update & UPDATE MODULE 
DMSUTL cmsgend loadlib @ LOADLIB MODULE 
DMSXMS cmsgend dmsxms DMSXMS MODULE (see 
Note 4 on page 473) 
DMSXRE cmsgend dmsxre DMSXRE MODULE (see Note a 
4 on page 473) oe 
DMSZAP cmsgend zap & ZAP MODULE 
VMFCLEAR load vmfclear (origin trans nomap type @ VMFCLEAR MODULE 
genmod vmfclear module a (nomap system nostr 
all & 
VMFDATE cmsgend vmfdate Mf VMFDATE MODULE 
VMFDOS cmsgend vmfdos & ~ VMFDOS MODULE | 
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Table 12 (Page 5 of 5). CMSGEND Files 
Assemble File 


Name Command to Type In File Created by this Command 
VMFLOAD cmsgend vmfload @ VMFLOAD MODULE 


Notes: | 


. When the CMSGEND EXEC procedure is invoked for EDIT, it creates the EDIT module. Then 
it automatically reinvokes itself to create the EDMAIN module. 


2. When the CMSGEND EXEC is invoked for TAPE, it creates the TAPE module and then 
reinvokes itself to create the DMSLMX and DMSTPx modules. 


. You get messages DMSSLKO0008W and DMSSOP036E when you regenerate PROPLIB. You 
can ignore them. 


. All EDIT source files, except DMSXMS and DMSXRE, are contained within the CMS nucleus. 


( : 4. Test any changed CMS commands. 
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Step 7. Regenerate System Product Interpreter Programs 


Do this step if: 


¢ You are processing program update service and have local modifications to 


System Product Interpreter programs (EXECs and XEDIT macros) 
e You are processing corrective service 
e You are processing local service. 


1. Establish the appropriate minidisk access order: 


setup @ 
vmfsetup 56643082 cms (bid @ 


2. Find out whether you have received service for any System Product Interpreter programs (EXECs or 
XEDIT macros): 


| [ | 
listfile * EXEC fm (exec @ The updates are on the alternate LOCALI Se 
rename cms exec a execfix = = Mf (395) disk if you are applying corrective 
listfile * XEDIT fm (exec @ service, or on the alternate DELTA (593) disk 
rename cms exec a xeditfix = = if you are applying program update service. 
The exec option saves the list in a file called 
CMS EXEC. Any previously existing CMS 
EXEC on your A-disk is erased. 
3. Examine the list of EXECs and XEDIT macros to which you have applied service and find out whether (“ * 


you have local modifications (including corrective service not included on the PUT you are processing) 
for any of them. 


Warning: The $VMFAPP $ERRLOG file will not identify these EXECs and XEDIT macros for you. 
You must know what local modifications you have made. 


4. Copy the latest version of the base code for each EXEC or XEDIT macro for which you have both IBM 
service and local modifications to the CMS alternate LOCALI disk (395). 


copy fn {$EXEC|$XEDIT} fm ==b Mf at 


5. Regenerate any EXECs or XEDIT macros for which you have received service and for which you have al 
local modifications: 


execupdt fn ft b (ctl dmsxa options Ml | ft is EXEC or XEDIT, without the dollar sign. 
DMSXA is the CMS control filename. 


For any files with a SID code in columns 63 
through 71, use the HIST and SID options. 
For all other files, including the following: 


PROPEPIF EXEC 
PROPHCHK EXEC 
PROPLGER EXEC 
PROPPCHK EXEC 
PROPPROF EXEC 
PROPRTCV EXEC 
PROPST EXEC 


use only the HIST option. 
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6. Erase the base code from the CMS alternate LOCALI disk: 


erase fn {$EXEC|$XEDIT} b @ 


7. Repeat substeps 4 on page 474 through 6 for each System Product Interpreter program that needs 
regenerating. 
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Step 8. Copy Changed Files to 0490 


1. Issue IPL 490 CLEAR. 


ip] 490 clear B 

VM/XA ALTCMS mm/dd/yy 

a 

Ready; T=n.nn/n.nn hh:mm:ss 


2. Establish the appropriate minidisk access order: 


setup & 
vmfsetup 56643082 cms (all @ 


7 Do the next substep if you want to make the macro libraries you created in Step 
1 and Step 2 available to general users. 


3. If you want to make either CMSNEW MACLIB or CPNEW MACLIB available to general users, copy it ‘ 
to the alternate CMS BUILD! disk (the M-disk). 
copy fn maclib fm = = m2 (olddate replace M@ 
For each new executable module created by running the CMSGEND EXEC in 
Step 6, repeat the next two substeps. 
| | aa SOs 
4. Save the new executable modules on MAINT’s 490 disk: \ = 
copy fn ft a = = m2 (olddate replace @ Substitute for fn and ft the name listed in the 
Ready; T=n.nn/n.nn hh:mm:ss rightmost column of Table 12 on page 469 
that corresponds to the ASSEMBLE file that 
you serviced. 
The replace option on the COPY command 
causes the command to overlay the file (fn 
MODULE) on the 490 minidisk, if it already x 
exists there. ( 


5. Erase the copy that is still out on the 191 disk: 


erase fn ft a @ 
Ready; T=n.nn/n.nn hh:mm:ss 


For each EXEC or XEDIT macro you serviced, whether you regenerated it in 
Step 7 or not, repeat the next two substeps. | 


6. Check to see if the original EXEC or XEDIT macro was on MAINT’s 490 disk: 


listfile fn ft m @ 
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7. If the replaced or updated EXEC or XEDIT macro belongs on MAINT’s 490 disk, copy it there: 


copy fn ft fm = = m2 (olddate replace @ The macros are on the alternate LOCALI 

Ready; T=n.nn/n.nn hh:mm:ss (395) disk if you are applying corrective 
service, the alternate DELTA (593) disk if you 
are applying program update service. 


8. Make backup copies of all your alternate service minidisks and of your current DELTA, APPLY, and 
LOCAL minidisks, using the DASD Dump Restore program. 
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Step 9. Create Test EXECs and Files 


In this step, you will create the EXECs and files you need to create test named saved systems and saved 
segments. | 


1. Choose temporary names for all your new named saved systems and saved segments so that you do not 
overlay those you are working with until you are satisfied that the new ones work. This sample 
procedure uses the following names: 


Real name Temporary name 
: CMS ALTCMS 
CMSXA ALTCMSXA 
| DOSBAM ALTDSBAM 
DOSINST ALTDOSIN 
CMSDOS ALTDOS 
CMSBAM ALTBAM yak 
CMSVSAM ALTVSAM [| 
| CMSAMS ALTAMS ie 
| INSTHELP ALTINSHP 
| CMSINST ALTINST 
! HELP ALTHELP 
GCS ALTGCS 


2. Copy the SAMPNSS EXEC: 


setup Hi | : LN 
copy sampnss exec fm testnss = = Hf wo 


3. Edit the TESTNSS EXEC, changing all the real names to temporary names. 


xedit testnss exec HE 


When you have finished, the TESTNSS EXEC should look like this: 


[PRES ELN ESE SAA SE AERTS E Te PAS ARAN ASAE REEL AAA ST REAR MA eH | 


pe Virtual Machine / System Product 5664-308 salad f . “j 
pe Contains restricted materials of IBM | soll a 
jee Copyright (c) IBM _ Corporation 1988 id | 
pre Licensed Materials - Property of I BM | 


jx* Refer to Copyright Instructions: Form G120-2083 sid | 
[Pee E OETA EERE RE RAE RENAN RETA TNT Ree eae ae ON RENO R ey 
arg parml parm2 
Address Command 
Select 
when parml = 'ALTCMS' & parm2 = 'ALTCMSXA' then 
do; 
'CP DEFSYS ALTCMS O-A EW 20-22 EW EOQ-FFF SR MINSIZE=256K' 
'CP DEFSYS ALTCMSXA 0-A EW 20-22 EW EQQ-FFF SR MINSIZE=256K' 
end; 
WHEN PARM1 = 'ALTGCS' THEN 
'CP DEFSYS ALTGCS 0-6 EW 400-5FF SW MINSIZE=256K VMGROUP RSTD' 
when parml = 'ALTINST' then 
'CP DEFSEG ALTINST CQ0-C4F SR SPACE ALTINSHP' QQ y | 
WHEN PARM1 = 'ALTHELP' THEN | i 
‘CP DEFSEG ALTHELP C5Q-C9F SR SPACE ALTINSHP' 
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10. 


WHEN PARM1 = 'ALTDOS' THEN 
‘CP DEFSEG ALTDOS BOO-BOF SR SPACE ALTDSBAM' 
WHEN PARM1 = 'ALTBAM' THEN 
'CP DEFSEG ALTBAM B10-B3F SR SPACE ALTDSBAM' 
WHEN PARM1 = 'ALTVSAM' THEN 
'CP DEFSEG ALTVSAM BAO-BFF SR A30-A3F EW SPACE ALTDSBAM' 
WHEN PARM1 = 'ALTAMS' THEN 
'CP DEFSEG ALTAMS B4Q-B9F SR AQO-A2F EW SPACE ALTDSBAM' 
Otherwise 
do; 
say ‘Unrecognized Parameters passed - ' parml parm2 
end; 
End /* Select */ 
'CP QUERY NSS ALL’ 
Exit 


. File the TESTNSS EXEC: 


file Hi 


. Copy the latest version of the SAMGEN EXEC: 


copy samgen exec fm altsamgn = = @ 


. Edit the ALTSAMGN EXEC, changing CMSBAM to ALTBAM throughout. 


xedit altsamgn exec 
change/CMSBAM/ALTBAM/* * 
file @ 


. Copy CMSBAM MAP and CMSBAM DOSLIB as ALTBAM MAP and ALTBAM DOSLIB: 


copy cmsbam map fm altbam = = HF 
copy cmsbam doslib fm altbam = = @ 


. Copy the latest version of the VSAMGEN EXEC: 


copy vsamgen exec fm altvsamg = = @ 


. Edit the ALTVSAMG EXEC, changing CMSVSAM to ALTVSAM and CMSAMS to ALTAMS 


throughout. 


xedit altvsamg exec @ 
change/CMSVSAM/ALTVSAM/* * 
top & 
change/CMSAMS/ALTAMS/* * 
file 


Copy all files with a filename of CMSVSAM, CMSAMS, or CMSAMS-«x giving the copies filetypes of 
ALTVSAM, ALTAMS, and ALTAMSx: 


filelist cmsvsam * * 


copy cmsvsam ft fm altvsam = = @ 
filelist cmsams* * * @ 

copy cmsams ft fm altams = = 
copy cmsamsx ft fm altamsx = = @ 
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11. You may have created a load list for the DCSSGEN command during the installation process. The one 
created in the sample installation process was called INSTLIST FILE. It should be on your A-disk 
(191). If itis not there, you probably used the IBM-supplied load list. This load list is called CMSINST o 

EXECLIST. It should be on your 193 disk. Copy one of these load lists as ALTINST EXECLIST: ae 


copy fn ft fm altinst execlist k | 


Vy 
Sa a gf 
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Step 10. Build Test Named Saved Systems 
1. Use the TESTNSS EXEC to define segments and save your new CMS and CMSXA: 


testnss altcms altcmsxa Hf The TESTNSS EXEC issues the DEFSYS 
command. 
HCPNSD440I The Named Saved System (NSS) ALTCMS Note that the names are positional on the 
was successfully defined in fileid TESTNSS command (the System/370 name 
fileno. followed by the 370-XA name). 


HCPNSD440I The Named Saved System (NSS) ALTCMSXA 


be, Seen os The TESTNSS EXEC first issues the DEFSYS 
was successfully defined in fileid 


command to define a skeleton system data file 


TusenOs for ALTCMS and for ALTCMSXA. These 
messages tell you the DEFSYS commands 
were successful. 

( | OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS nonn NSS S_— nnnn mn/dd hh:mm:ss ALTCMS NSS MAINT 


*NSS nonn NSS S_— nnnn mm/dd hh:mm:ss ALTCMSXA NSS MAINT 


Ready; T=n.nn/n.nn hh:mm:ss 
The TESTNSS EXEC issues a QUERY NSS 
command. These messages show what system 
C data files are defined. 


2. Issue the QUERY NSS ALL MAP command to make sure ALTCMS is defined properly. Check to see 
whether the information under BEGPAG, ENDPAG, TYPE, and CL in the response to QUERY NSS 
ALL MAP is the same as shown. 


query nss all map @ 
FILE FILENAME FILETYPE MINSIZE BEGPAG ENDPAG TYPE CL #USERS PARMREGS VMGROUP 


nonn ALTCMS = NSS Q00256K 00000 OO00A EW S 00000 OMITTED NO 


CC 00020 00022 EW 
. OOEOO OOFFF SR 
nonn ALTCMSXA NSS Q000256K 00000 OOO0A EW S 00000 OMITTED NO 


00020 00022 #&£€EW 
QOEOO OOFFF SR 
3. Set your machine mode to 370, load CMS (IPL 490), and save the ALTCMS system. 
set machine 370 Hf 


ip] 490 clear parm savesys altcms @ Load 490 with the option to save the system 
under the name ALTCMS. 


HCPNSS440I The named saved system ALTCMS was 
successfully saved in fileid fileno. 
VM/XA ALTCMS mm/dd/yy 
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el . : Press ENTER to initialize ALTCMS. 
Ready; T=n.nn/n.nn hh:mm:ss - | | 


4. Set your machine mode to XA, load CMS (IPL 490), and save the ALTCMSXA system. 


set machine xa @ 


ip] 490 clear parm savesys altcmsxa @ Load 490 with the option to save the system 
under the name ALTCMSXA. 


HCPNSS440I The named saved system ALTCMSXA was 
successfully saved in fileid fileno. 
VM/XA ALTCMS mm/dd/yy 


a Press ENTER to initialize ALTCMSXA. 
Ready; T=n.nn/n.nn hh:mm:ss a = 
5. Set your machine mode to 370 (or XA), redefine your virtual storage to 2 megabytes, and load the 
ALTCMS (or ALTCMSXA) named saved system. The example below shows loading ALTCMS in 
System/370 mode: 
set machine 370 @ 
define storage 2m & 
STORAGE = 2M Defining storage causes a system reset. = 
STORAGE CLEARED - SYSTEM RESET =e 
ipl altcms @ 
VM/XA ALTCMS mm/dd/yy 
| After receiving the version identification, press 
Ready; T=n.nn/n.nn hh:mm:ss ENTER to complete ALTCMS or 
ALTCMSXA initialization. 
a ~ 
ey 
a 
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6. Check the ALTCMS status by issuing QUERY NSS ALL and QUERY NSS ALL MAP. Check to find 
out whether the information under FILENAME and FILETYPE in the response to QUERY NSS ALL 
is the same as shown. Also, check whether the information under BEGPAG, ENDPAG, TYPE, and CL 


query nss all @ | 
OWNERID FILE TYPE CL RECS DATE TIME 


in the response to QUERY NSS ALL MAP is the same as shown. The system data file should now have 
class A (rather than S) and have one user (MAINT). 


FILENAME FILETYPE ORIGINID 


*NSS nnnn NSS A nnnn mn/dd hh:mm:ss ALTCMS 
*NSS nnonn NSS A nnnn mm/dd hh:mm:ss ALTCMSXA NSS MAINT 


Ready; T=n.nn/n.nn hh:mm:ss 
query nss all map @ 


NSS MAINT 


FILE FILENAME FILETYPE MINSIZE BEGPAG ENDPAG TYPE CL #USERS PARMREGS VMGROUP 


nonn ALTCMS = NSS 000256K 00000 


00020 

( : é 00E00 
7. nnnn ALTCMSXA NSS 000256K 00000 
00020 

O0E0O 


Ready; T=n.nn/n.nn hh:mm:ss 


Het, 


Q0000A 
00022 
OOFFF 
QO00A 
00022 
OOFFF 


EW 
EW 
SR 
EW 
EW 
SR 


A 90001 OMITTED NO 


A Q90000 OMITTED NO 


From now until you do Step 17, IPL your alternate (test) CMS system 
(ALTCMS or ALTCMSXA) instead of your current (production) CMS. 
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Step 11. Install Test CMSDOS, CMSBAM, CMSVSAM, and CMSAMS 
Saved Segments | 


Warning: Do not skip this step even if you have not changed CMSDOS, 
CMSBAM, CMSVSAM, or CMSAMS. 


Warning: The test CMSDOS and CMSBAM segments must be installed 
before you install the test CMSVSAM and CMSAMS segments. 


1. Define your storage as 16 megabytes and IPL your new CMS system. 


define storage 16m @ 

STORAGE = 0016M 

STORAGE CLEARED - SYSTEM RESET 

ip] altcms | 

DMSINS3271I The installation saved segment could not be loaded 


VM/XA ALTCMS mm/dd/yy This is a sample version header. 
** DO NOT press ENTER! ** 


access (noprof M@ | This command suppresses execution of 
MAINT’s PROFILE EXEC. 


2. Establish the appropriate minidisk access order: 


setup 

3. Issue: 
set emsg on Mf You want to see any and all error messages 
Ready; T=n.nn/n.nn hh:mm:ss during execution of the installation EXEC. 


4. Define a segment into which the DOSGEN EXEC can load ALTDOS. 


defseg altdosin 900-90f sr & 


HCPNSD440I Saved segment ALTDOSIN was successfully This command defines a 1MB segment for 
defined in fileid fileno ALTDOSIN starting at 900000. You may 
Ready; T=n.nn/n.nn hh:mm:ss place this segment anywhere below the segment 
spaces defined for ALTDOS, ALTBAM, 
ALTVSAM, and ALTAMS. 


484 Installation and Service 


a 
a 


=] 


5. Invoke the DOSGEN EXEC with a load address and the name ALTDOSIN. The load agate used for 
ALTDOSIN in this example is 900000. 


( ; dosgen 900000 altdosin lm 


HCPNSS440I Saved segment ALTDOSIN was successfully The load address and name are those 


saved in fileid fileno recommended for the ALTDOSIN segment. 
PRT FILE fileno SENT FROM MAINT PRT AS fileno Error messages for the DOSGEN EXEC are 
RECS nnnn COPY 001 A NOHOLD NOKEEP listed on page 486. 


DMSWGN715I DOSGEN COMPLETE 
Ready; T=n.nn/n.nn hh:mm:ss 


6. Re-IPL your new CMS system: 


ipl altcms @ 
DMSINS327I The installation saved segment could not be loaded 
VM/XA ALTCMS mm/dd/yy 


( : ai 

7 SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


7. Establish the appropriate minidisk access order: 
setup # 
8. Define ALTDOS, ALTBAM, ALTAMS, and ALTVSAM: 


( “ set sysname cmsdos altdosin Use emsdos in this command, not altdos. 
Ready; T=n.nn/n.nn hh:mm:ss 


testnss altdos @ 
HCPNSD440I Saved segment ALTDOS was successfully 
defined in fileid fileno 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


aon? *NSS nann NSS A_onnnn mm/dd hh:mm:ss ALTCMS NSS MAINT 
( *NSS nnnn NSS nann mn/dd hh:mm:ss ALTCMSXA NSS MAINT 
*NSS nonn NSS noon mn/dd hh:mm:ss GCS NSS MAINT 


*NSS nonn NSS nonn mn/dd hh:mm:ss ALTINST DCSS MAINT 
*NSS nonn NSS nonn mn/dd hh:mm:ss ALTDSBAM DCSS MAINT 
*NSS nonn NSS S— nnnn mm/dd hh:mm:ss ALTDOS — DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


nN D> b> > 


testnss altbam @ 
HCPNSD440I Saved segment ALTBAM was successfully 
defined in fileid fileno 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS nonn NSS A—nnnn mm/dd hh:mm:ss ALTCMS = NSS MAINT 


*NSS nonn NSS S— nnnn mm/dd hh:mm:ss AMTBAM — DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 
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testnss altams Mi | 
HCPNSD440I Saved segment ALTAMS was successfully 
defined in fileid fileno 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS nonn NSS A= nnnn mm/dd hh:mm:ss ALTCMS — NSS MAINT 


*NSS nonn NSS) S_— nonn mn/dd hh:mm:ss ALTAMS ODCSS  — MAINT 
Ready; T=n.nn/n.nn hh:mm:ss | 


testnss altvsam 

HCPNSD4401. Saved segment ALTVSAM was successfully 

| defined in fileid fileno 

OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
! *NSS nonn NSS) A_nnnn mm/dd hh:mm:ss ALTCMS NSS MAINT 


*NSS nnnn NSS. S_ nnnn mm/dd hh:mm:ss ALTVSAM DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss | a 


9. Invoke the DOSGEN EXEC with a load address and the name ALTDOS. The load address set up by 
TESTNSS is B00000 for the name ALTDOS. 


| dosgen b00000 altdos @ The load address and name are those 
recommended for the ALTDOS segment. 

! Error messages for the DOSGEN EXEC are 
listed on page 486. — 


HCPNSS440I Saved segment ALTDOS was successfully | Ne r 
saved in fileid fileno 
PRT FILE fileno SENT FROM MAINT PRT AS fileno 
RECS nnnn COPY @01 A NOHOLD NOKEEP 
DMSGEN715I DOSGEN COMPLETE 
Ready; T=n.nn/n.nn hh:mm:ss 


10. To save the load map, rename it and copy it to the 193 minidisk (K). 

copy load map a altdos segmap k (replace i 

Ready; T=n.nn/n.nn hh:mm:ss ee 
Error Messages from DOSGEN 

If DOSGEN detects an error in the address that you specified: 

DMSGENO95E INVALID ADDRESS 

If DOSGEN cannot find a read/write accessed A-disk: 

DMSGENQO6E NO READ/WRITE A-DISK ACCESSED. 

If DOSGEN finds unresolved external references while loading the text files: 

DMSGEN111E DOSGEN FAILED DUE TO LOAD ERRORS. 

If DOSGEN detects an error while assigning the storage key or saving the segment: 

DMSGEN412S DOSGEN FAILED DUE TO SETKEY ERRORS 


DMSGEN141S DOSGEN FAILED DUE TO SAVESYS ERRORS 
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11. Replace the name CMSBAM (not ALTBAM) in the CMS SYSNAME table with any name that is NOT 
a name previously used as a segment name. | 


set sysname cmsbam sysname @ The SET SYSNAME command enters an 

Ready; T=n.nn/n.nn hh:mm:ss alternate name for CMSBAM in the 
SYSNAME table. Choose a name that was 
not used previously as a segment name. This 
command does not actually change the saved 
segment’s name, but keeps CP from finding 
and IPLing the segment at the wrong time. 


12. Place your CMS virtual machine in a CMS/DOS environment, then invoke ALTSAMGN to load the 
ALTBAM segment. You must give the EXEC an address at which to load the ALTBAM segment; this 
address also must match the address in the skeleton ALTBAM segment that you defined beforehand. 


set dos on @ This command places your virtual machine in 
a CMS/DOS environment. 


DMSSET400I SYSTEM sysname DOES NOT EXIST sysname is the name you chose in substep 11. 
DMSSET1101I 100K DOS partition defined 
at hexadecimal location 020000. 
Ready; T=n.nn/n.nn hh:mm:ss 
altsamgn @ 
DMSSGN363R ENTER LOCATION WHERE ALTBAM 
WILL BE LOADED AND SAVED: 


( ; b10000 Mi 
DMSSGN364I FETCHING ALTBAM... 
DMSFET710I PHASE DMSVBM ENTRY POINT AT LOCATION B100CO. 
DMSSGN366R ENTER NAME OF SYSTEM TO BE SAVED: 
altbam Hi 


HCPNSS440I Saved segment ALTBAM was successfully The messages indicate that the segment has 
oe saved in fileid fileno been loaded and saved. 
( DMSSGN3651 SYSTEM ALTBAM SAVED 
: Ready; T=n.nn/n.nn hh:mm:ss 


13. Access the disk that you defined for VSAM when you were installing the system (see Step 27 in 
Chapter 2, Step 27 in Chapter 3, or Step 29 in Chapter 4) as your A-disk. 


access vdevno a This puts the minidisk (vdevno) in read/write 
Ready; T=n.nn/n.nn hh:mm:ss mode. 
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14. Invoke ALTVSAMG EXEC: 
altvsamg @ | f » 
SELECT ONE OF THE FOLLOWING FUNCTIONS BY ENTERING THE NUMBER: Aa? 
1. INSTALL AMS _ (READ VSAM PRODUCT TAPE, BUILD DOSLIB, CREATE SEGMENT) 
2. INSTALL VSAM (READ VSAM PRODUCT TAPE, BUILD DOSLIB, CREATE SEGMENT) 
3. INSTALL VSAM AND AMS (READ VSAM PRODUCT TAPE, BUILD DOSLIB, CREATE SEGMENT) 
4, BUILD AMS (BUILD DOSLIB, CREATE SEGMENT) 
5. BUILD VSAM (BUILD DOSLIB, CREATE SEGMENT) 
6. BUILD VSAM AND AMS (BUILD DOSLIB, CREATE SEGMENT) 
7. RESTART AMS (CREATE SEGMENT) 
| 8. RESTART VSAM (CREATE SEGMENT) 
J 9. RESTART VSAM AND AMS (CREATE SEGMENT) 
10. QUIT (EXIT ALTVSAMG EXECUTION) 
ENTER RESPONSE... 


6 wf Choosing option 6 tells the EXEC to create 
both ALTVSAM and ALTAMS segments as 
new segments, without reading the text files 
from the VSAM product tape. 


If you want to install a new release of VSAM, 
instead of servicing the current release, you 
must erase all files associated with VSAM 
before you issue ALT VSAMG; then, when you ae 
| issue ALTVSAMG, you must choose option 3. ( 


| 
DMSVGN365R ONE OR MORE OF THE TEXT FILES LISTED IN THE CMSVSAM EXEC | 
ARE MISSING. THE VSAM PP PID TAPE SHOULD BE ON TAPE DRIVE 181 ! 
TO RESTORE THE FILES. ENTER: 
‘GO’ IF TAPE DRIVE IS READY TO LOAD FILES, 
‘QUIT’ TO STOP GENERATION PROCESS. 
go & 
Messages Ye ? 


While ALTVSAMG is processing, you may receive error and information messages. These messages 
are self-explanatory. Messages labeled 21011 are information messages from the linkage editor and 
may be ignored. 


Respond to the EXEC messages as they appear: 


DMSVGN362I LINK-EDITING ALTVSAM ... 
DMSVGN363I ALTVSAM DOSLIB CREATED ON DISK 'A'. 
DMSVGN370R ENTER 'GO' IF SAVED SYSTEM IS TO BE CREATED, 
OTHERWISE ENTER 'QUIT'. 
go @ 
DMSVGN363R ENTER LOCATION WHERE ALTVSAM SHARED WILL BE 
LOADED AND SAVED: 


bae00e & 
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DMSVGN363R ENTER LOCATION WHERE ALTVSAM NONSHARED WILL BE 
LOADED AND SAVED: 
a30000 


DMSVGN364I FETCHING ALTVSAM ... 

DMSFET710I PHASE DMSVVS ENTRY POINT AT LOCATION nnnnnn 

DSMVGN371R ALTVSAM IS LOADED, IF ZAPS ARE TO BE APPLIED GO INTO 
'CP' MODE, APPLY THE ZAPS AND THEN REPLY 'GO' 

go 

DMSVGN366R ENTER NAME OF SYSTEM TO BE SAVED: 


altvsam @ This name is the default name with which the 
segment was defined. 


DMSVGN365I SYSTEM ALTVSAM SAVED. 


DMSVGN368R ERASE ALTVSAM DOSLIB ? ... ENTER 'YES' OR 'NO': ‘a 
no @ 


DMSVGN362I LINK-EDITING ALTAMS ... 
DMSVGN363I ALTAMS DOSLIB CREATED ON DISK ‘A'. 
DMSVGN370R ENTER 'GO' IF SAVED SYSTEM IS TO BE CREATED, 
OTHERWISE ENTER 'QUIT'. 
go @ 
DMSVGN363R ENTER LOCATION WHERE ALTAMS SHARED WILL BE 
LOADED AND SAVED: 


b40000 @ This is the recommended location. 
DMSVGN363R ENTER LOCATION WHERE ALTAMS NONSHARED WILL BE 
LOADED AND SAVED: 

ade00e 

DMSVGN364I FETCHING ALTAMS ... 

DMSFET710I PHASE DMSVAS ENTRY POINT AT LOCATION nnnnnn 

DMSFET710I PHASE DMSVAN ENTRY POINT AT LOCATION nnnnnn 

DMSFET710I PHASE DMSVAX ENTRY POINT AT LOCATION nnnnnn 

DMSVGN371R ALTAMS IS LOADED, IF ZAPS ARE TO BE APPLIED GO INTO 
‘CP’ MODE, APPLY THE ZAPS AND THEN REPLY 'GQ' 

go & 

DMSVGN366R ENTER NAME OF SYSTEM TO BE SAVED: 


altams @ This name is the default name used for 
defining the segment. 

DMSVGN365I SYSTEM ALTAMS SAVED. 

DMSVGN368R ERASE ALTAMS DOSLIB ? ... ENTER 'YES' OR '‘NO': 


no & 
Ready; T=n.nn/n.nn hh:mm:ss 
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15. Set DOS off: 


set dos off 
Ready; T=n.nn/n.nn hh:mm:ss 


Note: If you loaded files from the VSAM product tape in substep 14 on page 488, do not erase them. 
You will need them in Step 18. 
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Step 12. Install Test CMSINST and HELP Saved Segments 


4 Warning: Do not skip this step even if you have not changed CMSINST or 
HELP. 


1. Make sure that you have the right NAMESAVE segments in your user directory: 


¢ You must have the NAMESAVE ALTHELP statement in your user directory in order to save the 
HELP file directory information in a test saved segment. 


e¢ If the ALTHELP segment is defined as a member of a segment space, you must have a NAMESAVE 
statement (for example, NAMESAVE ALTINSHP) in the directory entry for the user who invokes 
SAVEFD. SAVEFD specifies the name of the segment space. 


If you have to change the directory, be sure to issue DIRECTXA to bring the changed directory online. 
2. Log onto MAINT (unless you are continuing from the previous step). 
3. Check your virtual storage. If it is less than 16MB, issue the following: 
define storage l6m @ 
STORAGE CLEARED - SYSTEM RESET 
STORAGE = 0016M 
4. IPL your new CMS system. 


ipl altcms @ 
DMSWSP327I The installation saved segment could not be loaded 


VM/XA ALTCMS mm/dd/yy This is a sample version header. If you defined 
i your own version heading, your own heading 
SYNONYM SYN will appear. 


CP TERM MODE VM 


Ready; T=n.nn/n.nn hh:mm:ss Press ENTER to complete the CMS 


initialization. 
5. Establish the appropriate minidisk access order: 


setup Hi 

6. Release the INSTHELP segment so that you can define a test segment in the same space: 
segment release insthelp @ 

7. Define a segment for ALTINST. 


testnss altinst @ 
HCPNSD440QI Saved segment ALTINST was successfully 
defined in fileid fileno 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS nonn NSS A onnnn mm:dd hh:mm ALTCMS — NSS MAINT 


*NSS nonn NSS S—onnnn mm:dd hh:mm ALTINST DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 
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8. Define the ALTHELP segment: 


testnss althelp & 
HCPNSD440I Saved segment ALTHELP was successfully 

defined in fileid fileno : 3 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS nonn NSS) A_onnnn mm:dd hh:mm ALTCMS — NSS MAINT 


*NSS nnnn NSS) S— nnnn mm:dd hh:mm ALTINST DCSS MAINT 
*NSS ninn NSS) S— nnnn mm:dd hh:mm ALTHELP DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


9. Save both segments: 


saveseg altinst Mi Each member saved segment defined by 
SAMPNSS must be saved separately. 


eo, 
HCPNSS440I Saved segment ALTINST was successfully / 
saved in fileid fileno 
Ready; T=n.nn/n.nn hh:mm:ss 
saveseg althelp @ 
HCPNSS440I Saved segment ALTHELP was successfully 
saved in fileid fileno 
Ready; T=n.nn/n.nn hh:mm:ss 
10, Redefine each segment to create the skclcton segments Zz 
testnss altinst @ | ee 
HCPNSD440I Saved segment ALTINST was successfully 
defined in fileid fileno 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS nonn NSS A nnnn mm:dd hh:mm ALTCMS — NSS MAINT 
*NSS = sonnnn NSS) S_—sonnnn mm:dd hh:mm ALTINST DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 
(- 
Me? 


testnss althelp Mf 
HCPNSD440I Saved segment ALTHELP was successfully 
defined in fileid fileno 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS nonn NSS) A-onnnn mm:dd hh:mm ALTCMS — NSS MAINT 


*NSS nonnn NSS S— nnnn mm:dd hh:mm ALTINST DCSS MAINT 
*NSS nonn NSS S— nnnn mnz:dd hh:mm ALTHELP DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


11. Using the load list you copied in Step 9, issue the DCSSGEN command as follows: 
dcssgen altinst execlist k altinst Mi ALTINST EXECLIST K is the file ID of the 


file that contains the list of EXECs and editor 
macros to be loaded into the test segment. 


ALTINST is the name of the test segment. 
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HCPNSS440I Saved segment ALTINST was successfully 
saved in fileid fileno 
Ready; T=n.nn/n.nn hh:mm:ss 


Note: When you built your ALTCMS nucleus, if you indicated in the DMSNGP file (USEINST = YES) 
or in answer to the DMSINQ296R prompt that you wanted to use the installation segment (the 
default is YES), then this segment is used each time a user IPLs ALTCMS. If you previously 
indicated that you did not want to use the installation segment but now want to use it, you must 
modify the DMSNGP file to indicate that the segment should be used, then assemble the modified 
DMSNGP and rebuild ALTCMS. 


Messages from DCSSGEN Command 


While DCSSGEN is processing, you may receive error or warning messages that indicate specific 
conditions. If errors were encountered, after processing is complete you receive the following prompt: 


DMSEXG298R An error has been detected while building the 
DCSS. Do you still want the DCSS saved? 
Enter 1 (YES) or 0 (NO). 


( Enter 1 to disregard the error(s) and save the segment, or enter 0 to not save the segment. If you do 
j not save the segment, you receive the message: 


DMSEXG288I segname not saved 
If DCSSGEN encounters an error while saving the segment, you receive the message: 
DMSEXG288E dcssname not saved 


If your virtual machine is not large enough to contain the segment (you need 16M), you receive the 
message: 


( : DMSEXG284E The DCSS is not completely inside the virtual machine 


To correct this situation, increase the size of your virtual machine, re-I[PL ALTCMS, and reissue the 
DCSSGEN command. 


12. Define your virtual storage less than the address at which the ALTHELP segment is to be loaded. For 
example, if the ALTHELP segment is defined at X'C50000', define your storage as 12MB. 


define storage 12m MH 
Pa STORAGE CLEARED - SYSTEM RESET 
( STORAGE = 12M 


13. Re-IPL your test CMS system. 
ipl altcms @ 
VM/XA ALTCMS mm/dd/yy This is a sample version header. 
ae 
SYNONYM SYN 
CP TERM MODE VM 
Ready; T=n.nn/n.nn hh:mm:ss 


14. Establish the appropriate minidisk access order: 


setup 
vmfsetup 56643082 cms (bld @ 
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15. Issue the following commands to initialize and save the segment: 


savefd init vaddr label althelp @ vaddr is 49D for mixed-case American English, 
Ready; T=n.nn/n.nn hh:mm:ss 49C for uppercase American English. 


label is the CMS label assigned to the disk. (in 
this sample procedure, it is MNT49D or 
MNT49C.) 


savefd save vaddr label althelp @ 

DMSACP723I Z(19D) R/O 

HCPNSS440I Saved segment ALTHELP was successfully 
saved in fileid fileno 

Ready; T=n.nn/n.nn hh:mm:ss 


16. For more information about using the SAVEFD command to save minidisk file directory information in 
a saved segment, refer to VM/XA SP CMS Command Reference. For more information about saved 


segments, refer to VM/XA SP Guide to Saved Segments. “ % 
17. Verify that the ALTINST and ALTHELP segments were defined correctly: — 
query nss all @ | 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS fileno NSS A nnnn mm/dd hh:mm:ss ALTINSHP NSS MAINT 
*NSS = fileno NSS A nnnn mm/dd hh:mm:ss ALTINST NSS MAINT 
*NSS = fileno NSS A nnnn mm/dd hh:mm:ss ALTHELP NSS MAINT = 
- 
18. Redefine your storage before you continue: \ 
define storage 16m Mf 
STORAGE = 16M 
Storage cleared - system reset 
ipl] altcms 
VM/XA ALTCMS mm/dd/yy 
a 
SYNONYM SYN gees 
CP TERM MODE VM C F 


Ready; T=n.nn/n.nn hh:mm:ss 
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Step 13. Test the System 


Now that you have applied service to all necessary files, you must test the 
system to make sure that the problem has been fixed. 


1. Test the system. 


2. To allow selected users to test the system, have them issue the following commands: 


#cp link maint 490 490 rr @ 

password & 

set sysname cmsdos altdos M@ 

set sysname cmsbam altbam @ 

set sysname cmsvsam altvsam @ 

set sysname cmsams altams @ 
( ‘ ipl altcms @ 


If the service performs to your satisfaction, perform Steps 14 through 19 to 


rebuild your system on the 190 disk. If the service fails, then you must find the 
problem, correct it, and retest the system. 
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Step 14. Purge the Test Named Saved Systems and Saved 


Segments 


1. Issue QUERY NSS ALL to determine the spoolids of the test named saved systems and saved segments 
segments you created in Step 10, Step 11, and Step 12 (ALTCMS, ALTCMSXA, ALTDSBAM, 
ALTDOSIN, ALTDOS, ALTBAM, ALTVSAM, ALTAMS, ALTINSHP, ALTINST, and ALTHELP). 


query nss all @ 
TYPE CL RECS DATE TIME 


OWNERID FILE 


*NSS 
*NSS 
*NSS 
*NSS 
*NSS 
*NSS 
*NSS 
*NSS 
*NSS 
*NSS 
*NSS 


nnnn 
nnann 
nann 
nann 
nann 
nnann 
nnnn 
nnan 
nnann 
nnann 
nann 


NSS 
NSS 
NSS 
NSS 
NSS 
NSS 
NSS 
NSS 
NSS 
NSS 
NSS 


A 


~-rrrrrrr,Yrr > 


nnann 
nnann 
nnann 
nnann 
nnann 
nannn 
nnnn 
nnnan 
nann 
nnann 
nann 


mn/dd hh:mm: 
mn/dd hh:mm: 
mn/dd hh:mm: 
mn/dd hh:mn: 
mn/dd hh:mm: 
mn/dd hh:mn: 
mn/dd hh:mm: 
mn/dd hh:mm: 
mn/dd hh:mm: 
mn/dd hh:mm: 
mn/dd hh:mm: 


Ready; T=n.nn/n.nn hh:mm:ss 


SS 
SS 
SS 
SS 
SS 
SS 
SS 
SS 
SS 
SS 
SS 


FILENAME 
ALTCMS 
ALTCMSXA 
ALTDSBAM 
ALTDOSIN 
ALTDOS 
ALTBAM 
ALTVSAM 
ALTAMS 
ALTINSHP 
ALTINST 
ALTHELP 


2. Purge the named saved systems and saved segments: 


The PURGE NSS command will take effect as soon as all users stop using the named saved systems and 
saved segments. 
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purge nss spoolid! ... 
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spoolidn @ 


FILETYPE ORIGINID 
MAINT | 


NSS 

NSS 

DCSS 
DCSS 
DCSS 
DCSS 
DCSS 
DCSS 
DCSS 
DCSS 
DCSS 


The spoolid is the number in the second 
column, under the heading “FILE.” 


You can list as many spoolids as necessary on 
a single PURGE NSS command. 


MAINT 
MAINT 
MAINT 
MAINT 
MAINT 
MAINT 
MAINT 
MAINT 
MAINT 
MAINT 


Step 15. DDR Alternate Disks to System Disks 


1. Rename DMSNGP TEXT to save it. Then edit the DMSNGP ASSEMBLE file and make the following 
changes: 


a. Change SYSDISK = 490 to SYSDISK = 190. 
b. Change IPLADDR = 490 to IPLADDR = 190. 
c. Change HELP =49D to HELP=19D (or HELP =49C to HELP=19C). 


d. Change SYSNAME=newname to SYSNAME=CMS, where newname is the name you choose for 
your test system. The sample procedure in this chapter uses ALTCMS. 


e. Change INSTSEG =newname to SYSNAME=CMSINST, where newname is the name you choose 
for your test installation segment. The sample procedure in this chapter uses ALTINST. 


f. Change the VERSION = and INSTID= parameters to identify your new CMS system. 


( | These changes will cause the new CMS nucleus (with service) to be rebuilt on the 190 minidisk. 


2. Establish the appropriate minidisk access order: 
setup Mi 
3. Reassemble the DMSNGP ASSEMBLE file: 
vmfhasm dmsngp 56643082 cms @ 
4. Copy DMSNGP TEXT to the CMS alternate LOCALI disk (395): 
copy dmsngp text a = = b (replace 
5. Use the DASD DUMP Restore program to copy the 490 disk to the 190 disk. 
ddr @ 


VM/XA SYSTEM PRODUCT DASD DUMP RESTORE PROGRAM 
ENTER CARD READER ADDRESS OR CONTROL STATEMENTS. 


ENTER: 
~” sysprint cons This command tells DDR to send program 

ENTER: messages to your console. 

: input 490 devtype MNT490 @ 490 is your test CMS system disk. devtype is 

i ENTER: the device type of the DASD volume where 

490 is located. 

output 190 devtype MNT190 @ 190 is your new CMS system disk. devtype 1s 
ENTER: - the device type of the DASD volume where 


190 is located. 
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copy 000 endcyl @ 


DMKDDR711R Volid Read is MNT490. Do you 
wish to continue? 

yes 

ENTER NEXT EXTENT OR NULL LINE: 

a 


END OF COPY 
ENTER: 

mi 

END OF JOB 


6. Relabel the 190 minidisk: 


access 190 c @ 
DMSACP723I C(190) R/O 
DMSACC725I 190 ALSO = S DISK 


format 190 c (label @ 
ENTER LABEL: 

mnt190 @ 

Ready; T=n.nn/n.nn hh:mm:ss 
release c @ 

Ready; T=n.nn/n.nn hh:mm:ss 


The value for endcyl depends on the device 
type of your 490 disk: | 


Device Type endcyl 


3350 | 73 
3375 112 


3380 71 


You have not yet changed the label of the 190 
minidisk. (You do so in substep 6.) 


You must use the label option. If you don’t, 
you erase all the files on the 190 minidisk. 


| 7. Repeat substeps 5 on page 497 and 6 to copy the alternate HELP disks (49D, 49C, 49B...) to their 
: corresponding current disks (19D, etc.) and to relabel the current disks as MNT19n. Check the minidisk 


8. Erase DMSNGP TEXT from your A-disk: 
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erase dmsngp text a 
Ready; T=n.nn/n.nn hh:mm:ss 
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definitions in your user directory to find the appropriate value for endcyl. 


J 
SM us 


a 
Ke 


Step 16. Rebuild the Nucleus 


1. Establish the appropriate minidisk access order: 


setup @ 
2. Generate the new CMS nucleus: 
spool punch * class n @ 


spool prt * @ 
spool rdr class n @ 


| vmfbid 56643082 cms (punch @ If you are processing PUT service, use cms as 


| or the component name. 


If you are processing COR service, use corcms 


(— | vmfbid 56643082 corcms (punch @ 
ss as the component name. 


DMSBLD1851I Processing CMSLOAD with 
the part handler VMFBDNUC EXEC This invokes the VMFBLD EXEC to build a 
LOAD LIST: $$$TLL$$ EXEC Al (MNT191) new nucleus for CMS. The VMFBLD EXEC 
performs a number of system generation 
functions for you. For more information on 
this EXEC, see “VMFBLD EXEC” on 
page 679. 


( ° RDR FILE fileno SENT FROM MAINT PUN AS fileno The system loader punches the CMS nucleus. 
— RECS nnnn COPY 001 N NOHOLD NOKEEP This message tells you that the punch file is 
complete. 


Ready; T=n.nn/n.nn hh:mm:ss If you get return code 4, the reason may be 
that a PTF which is now being applied has 
another PTF, outside CMS, as a prerequisite. 
Check the S$VMFBLD $ERRLOG file for 

( i message DMSBNC1854W. 


| 3. Review the build exception log (SVMFBLD $ERRLOG). If necessary, correct any problems before 
| going on. 


| vnfview build @ 
4. IPL your virtual reader: 


ipl 00c @ 


DMSINS327I The installation saved segment could not be loaded. 


Informational message. The CMSINST 
installation segment has not been loaded and 


C | saved yet. 
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VM/XA CMS 5.5 mm/dd/yy hh:mm 
a 

SYNONYM SYN 

CP TERM MODE VM 


Ready; T=n.nn/n.nn hh:mm:ss The ready message indicates that the nucleus 
has been loaded to your 190 minidisk 


successfully. 


5. Query the reader to identify the CMS load map: 


query rdr * all @ 


ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE DIST 


MAINT  fileno M PUN nnnnnnnn 001 NONE mm/dd hh:mm:ss SYSPROG ean 
The CMS load map is the file with a blank 
filename and filetype. It has approximately 
8100 records. The exact size varies according 
to the system default language, local 
modifications, and VMSUP level. Note the 
fileno of this file. You will use it in your next 
command. 

6. Receive the CMS load map that is in your reader. ao 
fp 
ed 

spool prt * nohold @ 

close prt * @ 

setup The CMS map 1s loaded onto the CMS 
receive fileno cmsnuc map b (replace @ LOCAL I (0395) minidisk. 


CMSNUC MAP Bl created 

DMSRDC738I Record length is 132 bytes 

File CMSNUC MAP B received from MAINT at —_— 
nodeid as CMSNUC MAP B \ 

Ready; T=n.nn/n.nn hh:mm:ss 


Warning: From this point on, use IPL 190 instead of IPL 490 whenever you 


need to re-IPL CMS. The nucleus you just built is on the 190 disk; the old 
production nucleus (former current nucleus) is on the 490 disk. 
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Step 17. Rebuild Named Saved Systems 


1. Use the SAMPNSS EXEC to define segments and save your new CMS and CMSXA: 


sampnss cms cmsxa 


The SAMPNSS EXEC issues the DEFSYS 
command. 


HCPNSD440I The Named Saved System (NSS) CMS was Note that the names are positional on the 
successfully defined in fileid fileno. SAMPNSS command (the System/370 name 
HCPNSD440I The Named Saved System (NSS) CMSXA was followed by the 370-XA name). 


successfully defined in fileid fileno. 


OWNERID FILE TYPE CL RECS DATE TIME 


The SAMPNSS EXEC first issues the 
DEFSYS command to define a skeleton system 
data file for CMS and for CMSXA. These 
messages tell you the DEFSYS commands 
were successful. 


FILENAME FILETYPE ORIGINID 


*NSS nonn NSS) S— nnnn mm/dd hh:mm:ss CMS NSS MAINT 
*NSS nnnn NSS S_ nnnn mm/dd hh:mm:ss CMSXA NSS MAINT 


Ready; T=n.nn/n.nn hh:mm:ss 


The SAMPNSS EXEC issues a QUERY NSS 
command. These messages show what system 
data files are defined. 


2. Issue the QUERY NSS ALL MAP command to make sure CMS is defined properly. Check to see 
whether the information under BEGPAG, ENDPAG, TYPE, and CL in the response to QUERY NSS 


ALL MAP is the same as shown. 


query nss all map @ 
FILE FILENAME FILETYPE MINSIZE BEGPAG 


nonn CMS NSS 000256K 00000 
00020 
OOEOO 
nonn CMSXA NSS 000256K 00000 
00020 
QOQE0O 


ENDPAG TYPE CL #USERS PARMREGS VMGROUP 


000A 
90022 
OOFFF 
QO00A 
90022 
OOFFF 


EW S 00000 OMITTED NO 
EW ; 

SR 

EW S Q00000 OMITTED NO 
EW 

SR 


3. Set your machine mode to XA, load CMS (IPL 190), and save the CMS system. 


set machine 370 


ip] 190 clear parm savesys cms @ 


HCPNSS440I The named saved system CMS was 
successfully saved in fileid fileno. 


VM/XA CMS 5.5 mm/dd/yy hh:mm 


Load 190 with the option to save the system 
under the name CMS. 
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ze 
Ready; T=n.nn/n.nn hh:mm:ss 


Press ENTER to initialize CMS. 


4. Set your machine mode to XA, load CMS (IPL 190), and save the CMSXA system. 


set machine xa 


ip] 190 clear parm savesys cmsxa @ 


HCPNSS440I The named saved system CMSXA was 
successfully saved in fileid fileno. 
VM/XA CMS 5.5 mm/dd/yy hh:mm 


|_| 
Ready; T=n.nn/n.nn hh:mm:ss 


Load 190 with the option to save the system 
under the name CMSXA. 


5. Set your machine mode to 370 (or XA), redefine your virtual storage to 2 megabytes, and load the CMS 
(or CMSXA) named saved system. The example below shows loading CMS in System/370 mode: 
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set machine 370 @ 
define storage 2m Hf 


STORAGE = 2M 
STORAGE CLEARED - SYSTEM RESET 
ip] cms @ 

VM/XA CMS 5.5 mm/dd/yy hh:mm 


m 
Ready; T=n.nn/n.nn hh:mm:ss 
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Defining storage causes a system reset. 


After receiving the version identification, press 
ENTER to complete CMS or CMSXA 
initialization. 


6. Check the CMS status by issuing QUERY NSS ALL and QUERY NSS ALL MAP. Check to see 
whether the information under FILENAME and FILETYPE in the response to QUERY NSS ALL is 
the same as shown. Also, check whether the information under BEGPAG, ENDPAG, TYPE, and CL in 
the response to QUERY NSS ALL MAP 1s the same as shown. The system data file should now have 
class A (rather than S) and have one user (MAINT). 


query nss all @ 
OWNERID FILE TYPE CL RECS DATE TIME 


FILENAME FILETYPE ORIGINID 


*NSS nonn NSS A nnnn mm/dd hh:mm:ss CMS NSS MAINT 
*NSS nonn NSS A_—nnnn mm/dd hh:mm:ss CMSXA NSS MAINT 


Ready; T=n.nn/n.nn hh:mn:ss 
query nss all map @ 


FILE FILENAME FILETYPE MINSIZE BEGPAG ENDPAG TYPE CL #USERS PARMREGS VMGROUP 


nonn CMS NSS 000256K 00000 
00020 
OOEOO 
nnonn CMSXA NSS 000256K 90000 
00020 
Q0EOO 


Ready; T=n.nn/n.nn hh:mm:ss 


QO00A 
00022 
OOF FF 
QO00A 
00022 
OOF FF 


EW A 00001 OMITTED NO 


EW A 90000 OMITTED NO 
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Step 18. Reinstall the CMSDOS, CMSBAM, CMSVSAM, and 
CMSAMS Saved Segments 


Warning: Do not skip this step even if you have not changed CMSDOS, 
CMSBAM, CMSVSAM, or CMSAMS. 


“Warning: The CMSDOS and CMSBAM segments must be installed before 
you install the CMSVSAM and CMSAMS segments. 


1. Define your storage as 16 megabytes and IPL your new CMS system. 


define storage 16m @ 

STORAGE = 0016M 

STORAGE CLEARED - SYSTEM RESET 
ip] cms 


VM/XA CMS 5.5 mm/dd/yy hh:mm 
** DO NOT press ENTER! ** 


access (noprof This command suppresses execution of 
| MAINT’s PROFILE EXEC. 


Z. Esiablisn the appropriate minidisk access order: 


setup 

3. Issue: 
set emsg on @ You want to see any and all error messages 
Ready; T=n.nn/n.nn hh:mm:ss during execution of the installation EXEC. 


4. Define a segment into which the DOSGEN EXEC can load CMSDOS. 


defseg dosinst 900-90f sr @& 


HCPNSD440I Saved segment DOSINST was successfully This command defines a 1MB segment for 
defined in fileid fileno DOSINST starting at 900000. You may place 
Ready; T=n.nn/n.nn hh:mm:ss this segment anywhere below the segment 
spaces defined for CMSDOS, CMSBAM, 
CMSVSAM, and CMSAMS. 


5. Invoke the DOSGEN EXEC with a load address and the name DOSINST. The load address used for 
DOSINST in this example is 900000. 


dosgen 900000 dosinst @ 
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HCPNSS4401I Saved segment DOSINST was successfully 
saved in fileid fileno 
PRT FILE fileno SENT FROM MAINT PRT AS fileno 
RECS nnnn COPY 001 A NOHOLD NOKEEP 
DMSWGN715I DOSGEN COMPLETE 
Ready; T=n.nn/n.nn hh:mm:ss 


6. Re-IPL your new CMS system: 


ip] cms # 

VM/XA CMS 5.5 mm/dd/yy hh:mm 
| 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


7. Establish the appropriate minidisk access order: 


setup Mf 


set sysname cmsdos dosinst 

Ready; T=n.nn/n.nn hh:mm:ss 

sampnss cmsdos @ 

HCPNSD440I Saved segment CMSDOS was successfully 
defined in fileid fileno 

OWNERID FILE TYPE CL RECS DATE TIME 


The load address and name are those 
recommended for the DOSINST segment. 
Error messages for the DOSGEN EXEC are 


listed on page 486. 


8. Define CMSDOS, CMSBAM, CMSAMS, and CMSVSAM: 


FILENAME FILETYPE ORIGINID 


*NSS nonn NSS A nnnn mm/dd hh:mm:ss CMS 
*NSS nonn NSS) A_onnnn mm/dd hh:mm:ss CMSXA 
*NSS nonn NSS A nnnn mm/dd hh:mm:ss GCS 
*NSS nonn NSS A nnnn mm/dd hh:mm:ss DOSINST 
*NSS nonn NSS S— nann mm/dd hh:mm:ss DOSBAM 
*NSS nonn NSS S— nnnn mm/dd hh:mm:ss CMSDOS 


NSS MAINT 
NSS MAINT 
NSS MAINT 
DCSS MAINT 
DCSS MAINT 
DCSS MAINT 


Ready; T=n.nn/n.nn hh:mm:ss 


sampnss cmsbam 

HCPNSD440I Saved segment CMSBAM was successfully 
defined in fileid fileno 

OWNERID FILE TYPE CL RECS DATE TIME FILENAME 

*NSS nonn NSS) A nnnn mm/dd hh:mm:ss CMS 


*NSS nonn NSS S— nann mm/dd hh:mm:ss CMSBAM 
Ready; T=n.nn/n.nn hh:mm:ss 


sampnss cmsams 

HCPNSD4401 Saved segment CMSAMS was successfully 
defined in fileid fileno 

OWNERID FILE TYPE CL RECS DATE TIME FILENAME 

*NSS nonn NSS A nnnn mm/dd hh:mm:ss CMS 


*NSS nonn NSS S— nnnn mm/dd hh:mm:ss CMSAMS 
Ready; T=n.nn/n.nn hh:mm:ss 


FILETYPE ORIGINID 
NSS MAINT 


DCSS MAINT 


FILETYPE ORIGINID 
NSS MAINT 


DCSS MAINT 
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Sampnss cmsvsam 
HCPNSD440I Saved segment CMSVSAM was successfully 

defined in fileid fileno | 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS nnnn NSS A_ nnnn mm/dd hh:mm:ss CMS NSS MAINT 


*NSS nonn NSS) S_ nnonn mm/dd hh:mm:ss CMSVSAM DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


9. Invoke the DOSGEN EXEC with a load address and the name CMSDOS. The load address set up by 
SAMPNSS is B00000 for the name CMSDOS. 


dosgen b00000 cmsdos @ The load address and name are those 
recommended for the CMSDOS segment. 
Error messages for the DOSGEN EXEC are 


listed on page 486. 


HCPNSS440I Saved segment CMSDOS was successfully 
saved in fileid fileno 
PRT FILE fileno SENT FROM MAINT PRT AS fileno 
RECS nnnn COPY 001 A NOHOLD NOKEEP 
DMSGEN715I DOSGEN COMPLETE 
Ready; T=n.nn/n.nn hh:mm:ss 


10. To save the load map, rename it and copy it to the 193 minidisk (K). 


copy load map a cmsdos segmap k (replace @ 
Ready; T=n.nn/n.nn hh:mm:ss 


11. Replace the name CMSBAM in the CMS SYSNAME table with any name that is NOT a name 
previously used as a segment name. 


set sysname cmsbam sysname The SET SYSNAME command enters an 

Ready; T=n.nn/n.nn hh:mm:ss | alternate name for CMSBAM in the 
SYSNAME table. Choose a name that was 
not used previously as a segment name. This 
command does not actually change the saved 
segment’s name, but keeps CP from finding 
and IPLing the segment at the wrong time. 


12. Place your CMS virtual machine in a CMS/DOS environment, then invoke SAMGEN to load the 


CMSBAM segment. You must give the EXEC an address at which to load the CMSBAM segment; this | 


address also must match the address in the skeleton CMSBAM segment that you defined beforehand. 


set dos on This command places your virtual machine in 
a CMS/DOS environment. 


DMSSET4001 SYSTEM sysname DOES NOT EXIST sysname is the name you chose in substep 11. 
DMSSET11011 100K DOS partition defined 
at hexadecimal location 020000. 
Ready; T=n.nn/n.nn hh:mm:ss 
samgen @ 
DMSSGN363R ENTER LOCATION WHERE CMSBAM 
WILL BE LOADED AND SAVED: 


506 Installation and Service | 


b10000 @ 


DMSSGN3641 FETCHING CMSBAM... | 
DMSFET710I PHASE DMSVBM ENTRY POINT AT LOCATION B100CO. 
DMSSGN366R ENTER NAME OF SYSTEM TO BE SAVED: 


cmsbam @ 


HCPNSS440I Saved segment CMSBAM was successfully The messages indicate that the segment has 
saved in fileid fileno been loaded and saved. 
DMSSGN365I SYSTEM CMSBAM SAVED 


Ready; T=n.nn/n.nn hh:mm:ss 


13. Access the VSAM product disk (the same disk you accessed in substep 13 on page 487 of Step 11) as 


your A-minidisk. 


access vdevno a ff 


Ready; T=n.nn/n.nn hh:mm:ss 


14. Invoke VSAMGEN EXEC: 


vsamgen 


SELECT ONE OF THE FOLLOWING FUNCTIONS BY ENTERING THE NUMBER: 


INSTALL AMS 

INSTALL VSAM 

INSTALL VSAM AND AMS 
BUILD AMS 

BUILD VSAM 

BUILD VSAM AND AMS 
RESTART AMS 

RESTART VSAM 

RESTART VSAM AND AMS 
QUIT 


Cowoowon nn om & W PP re 


— 


ENTER RESPONSE... 


6 & 


Messages 


(READ VSAM PRODUCT TAPE, BUILD DOSLIB, CREATE SEGMENT) 
(READ VSAM PRODUCT TAPE, BUILD DOSLIB, CREATE SEGMENT) 
(READ VSAM PRODUCT TAPE, BUILD DOSLIB, CREATE SEGMENT) 
(BUILD DOSLIB, CREATE SEGMENT) 

(BUILD DOSLIB, CREATE SEGMENT) 

(BUILD DOSLIB, CREATE SEGMENT) 

(CREATE SEGMENT) 

(CREATE SEGMENT) 

(CREATE SEGMENT) 

(EXIT VSAMGEN EXECUTION) 


Choosing option 6 tells the EXEC to create 
both CMSVSAM and CMSAMS segments as 
new segments, without reading the text files 
from the VSAM product tape. If you read in 
new files from the VSAM product tape in 
substep 14 on page 488 of Step 11, you will 
use those files now. 


While VSAMGEN is processing, you may receive error and information messages. These messages 
are self-explanatory. Messages labeled 21011 are information messages from the linkage editor and 


may be ignored. 
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Respond to the EXEC messages as they appear: | \ 
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DMSVGN3621 LINK-EDITING CMSVSAM ... 

DMSVGN363I CMSVSAM DOSLIB CREATED ON DISK ‘A’. 

DMSVGN370R ENTER 'GO' IF SAVED SYSTEM IS TO BE CREATED, 
OTHERWISE ENTER ‘QUIT’. 


go @ 
DMSVGN363R ENTER LOCATION WHERE CMSVSAM SHARED WILL BE 
LOADED AND SAVED: 


ba000e 


DMSVGN363R ENTER LOCATION WHERE CMSVSAM NONSHARED WILL BE 
LOADED AND SAVED: 


a30000 
me 
DMSVGN364I FETCHING CMSVSAM ... . 
DMSFET710I PHASE DMSVVS ENTRY POINT AT LOCATION nnnnnn 
DSMVGN371R CMSVSAM IS LOADED, IF ZAPS ARE TO BE APPLIED GO INTO 
'CP' MODE, APPLY THE ZAPS AND THEN REPLY 'GO' 
go & 
DMSVGN366R ENTER NAME OF SYSTEM TO BE SAVED: 
cmsvsam This name is the default name with which the fo 
segment was defined. a ro 
DMSVGN365I SYSTEM CMSVSAM SAVED. 
DMSVGN368R ERASE CMSVSAM DOSLIB ? ... ENTER 'YES' OR 'NO': 
no @ 
DMSVGN362I LINK-EDITING CMSAMS ... -_ 
DMSVGN363I CMSAMS DOSLIB CREATED ON DISK ‘A’. eH 


DMSVGN370R ENTER 'GO' IF SAVED SYSTEM IS TO BE CREATED, 
OTHERWISE ENTER ‘QUIT’. 
go & 
DMSVGN363R ENTER LOCATION WHERE CMSAMS SHARED WILL BE 
LOADED AND SAVED: 
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b40000 & This is the recommended location. 
DMSVGN363R ENTER LOCATION WHERE CMSAMS NONSHARED WILL BE 
LOADED AND SAVED: 

a0e0e0e 

DMSVGN3641I FETCHING CMSAMS ... 

DMSFET710I PHASE DMSVAS ENTRY POINT AT LOCATION nnnnnn 

DMSFET710I PHASE DMSVAN ENTRY POINT AT LOCATION nnnnnn 

DMSFET710I PHASE DMSVAX ENTRY POINT AT LOCATION nnnnnn 

DMSVGN371R CMSAMS IS LOADED, IF ZAPS ARE TO BE APPLIED GO INTO 
'CP' MODE, APPLY THE ZAPS AND THEN REPLY 'GO' 

go & 

DMSVGN366R ENTER NAME OF SYSTEM TO BE SAVED: 


cmsams This name is the default name used for 
defining the segment. 
DMSVGN365I SYSTEM CMSAMS SAVED. 
DMSVGN368R ERASE CMSAMS DOSLIB ? ... ENTER 'YES' OR 'NO': 
no @ 
Ready; T=n.nn/n.nn hh:mm:ss 
15. You may now purge the DOSINST named saved segment: 
query nss all @ 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS nonn NSS A nnnn mm/dd hh:mm:ss CMS NSS MAINT 
*NSS nonn NSS A nnnn mm/dd hh:mm:ss DOSINST DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 
purge nss fileno @ fileno is the file identifier for DOSINST. 
No files purged 
0001 file pending purged 
Ready; T=n.nn/n.nn hh:mm:ss 


16. Set DOS off: 


set dos off Mf 
Ready; T=n.nn/n.nn hh:mm:ss 
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Step 19. Reinstall the CMSINST and HELP Saved Segments 


1. Make sure that you have the right NAMESAVE segments in your user directory: 


¢ You must have the NAMESAVE HELP statement in your user directory in order to save the HELP 
file directory information in a saved segment. 


e If the HELP segment is defined as a member of a segment space, you must have a NAMESAVE 
statement (for example, NAMESAVE INSTHELP) in the directory entry for the user who invokes 
SAVEFD. SAVEFD specifies the name of the segment space. 


2. Log onto MAINT (unless you are continuing from the previous step). 


3. Check your virtual storage. If it is less than 16MB, issue the following: 


define storage 16m @ 
STORAGE CLEARED - SYSTEM RESET 
STORAGE = 0016M 

4. IPL your new CMS system. 


ip] cms @ 
VM/XA CMS 5.5 mm/dd/yy hh:mn 


a Press ENTER to complete the CMS 
SYNONYM SYN initialization. 


CP TERM MODE VM 
Ready; T=n.nn/n.nn hh:mm:ss 

5. Establish the appropriate minidisk access order: 
setup 

6. Purge your old CMSINST segment: 


segment purge cmsinst @ 
Ready; T=n.nn/n.nn hh:mm:ss 


510 Installation and Service 


wy 


7. Define a segment for CMSINST: 


sampnss cmsinst Mf 
HCPNSD440I Saved segment CMSINST was successfully 
defined in fileid fileno 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS nnnn NSS) A—onnnn mn:dd hh:mm CMS NSS MAINT 


*NSS nonn NSS S— nnnn mn:dd hh:mm CMSINST DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


The EXEC issues a QUERY command that 
displays information about the segments defined for 
named saved systems. 


8. Define the HELP segment: 


( sampnss help @ 
: HCPNSD440I Saved segment HELP was successfully 
defined in fileid fileno 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS nnonn NSS) A-onnnn mm:dd hh:mm CMS NSS MAINT 


*NSS nnnn NSS S~— nnnn mm:dd hh:mm CMSINST DCSS MAINT 
*NSS nnnn NSS S~— nnnn mm:dd hh:mm HELP DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 


( s 9. Save both segments: 


saveseg cmsinst @ Each member saved segment defined by 
SAMPNSS must be saved separately. 


HCPNSS440I Saved segment CMSINST was successfully 
saved in fileid fileno 
7 Ready; T=n.nn/n.nn hh:mm:ss 
( - saveseg help 
ide HCPNSS440I Saved segment HELP was successfully 
saved in fileid fileno 
Ready; T=n.nn/n.nn hh:mm:ss 
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10. Redefine each segment to create the skeleton segments: 


sampnss cmsinst Hf 
HCPNSD4401I Saved segment CMSINST was successfully 
defined in fileid fileno | 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS noann NSS) A onnann mm:dd hh:mm CMS NSS MAINT 


*NSS nonn NSS S— nnnn mm:dd hh:mm CMSINST DCSS MAINT 
Ready; T=n.nn/n.nn hh:mm:ss 
sampnss help @ 
HCPNSD440I Saved segment HELP was successfully 

defined in fileid fileno 
_ OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 
*NSS = onnnn NSS) A_—onnnn mm:dd hh:mm CMS NSS MAINT 


*NSS nonn NSS S— nnnn mn:dd hh:mm CMSINST DCSS MAINT 
*NSS nonn NSS) S—onnnn mm:dd hh:mm HELP DCSS MAINT | cn 
Ready; T=n.nn/n.nn hh:mm:ss _— 


11. You may have created a load list for the DCSSGEN command during the installation process. The one 
created in the sample installation process was called INSTLIST FILE. It should be on your A-disk 
(191). If it is not there, you probably used the IBM-supplied load list. This load list is called CMSINST 
EXECLIST. It should be on your K-disk (193). Using one of these load lists, issue the DCSSGEN 
command as follows: 


dcssgen fn ft fm cmsinst & Jn ft fm is the fileid of the file that contains the 
list of EXECs and Editor macros to be loaded 
into the segment. 


CMSINST is the name of the segment. 
CMSINST is the default name used for 
defining the segment and for specifying the 
segment name in DMSNGP or in response to 
the installation questions. If you do not 
specify a segment name, the default name is 
CMSINST. 


( a 
oa 


HCPNSS440I Saved segment CMSINST was successfully 
saved in fileid fileno 
Ready; T=n.nn/n.nn hh:mm:ss 


Note: When you built your CMS nucleus, if you indicated in the DMSNGP file (USEINST = YES) or in 
answer to the DMSINQ296R prompt that you wanted to use the installation segment (the default 
is YES), then this segment is used each time a user IPLs CMS. If you indicated earlier that you 
did not want to use the installation segment but now want to use it, you must modify the 
DMSNGP file to indicate that the segment should be used, then assemble the modified DMSNGP 
and rebuild CMS. | 


12. Define your virtual storage as less than the address at which the HELP segment is to be loaded. For 
example, if the HELP segment is defined at X'C50000', define your storage as 12MB. 


define storage 12m @ 
STORAGE CLEARED - SYSTEM RESET 
STORAGE = 12M 
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13. Re-IPL your new CMS system. 


ip] cms 


VM/XA CMS 5.5 mm/dd/yy hh:mm 
_ 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 


14. Establish the appropriate minidisk access order: 
setup 
15. Issue the following commands to initialize and save the segment: 


savefd init vaddr label help @ vaddr is 19D for mixed-case American English, 
Ready; T=n.nn/n.nn hh:mm:ss 19C for uppercase American English. 


label is the CMS label assigned to the disk. 
(The labels in the sample directory are 
MNT19D and MNT19C.) 


savefd save vaddr label help @ 

DMSACP7231I Z(19D) R/O 

HCPNSS440I Saved segment HELP was successfully 
saved in fileid fileno 

Ready; T=n.nn/n.nn hh:mm:ss 


16. For more information about using the SAVEFD command to save minidisk file directory information in 
a saved segment, refer to VM/XA SP CMS Command Reference. For more information about saved 
segments, refer to VM/XA SP Guide to Saved Segments. 


17. Verify that the CMSINST and CMSHELP segments are defined correctly: 


query nss all @ 
OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID 


*NSS fileno NSS A nnnn mm/dd hh:mm:ss INSTHELP NSS MAINT 
*NSS fileno NSS A nnnn mm/dd hh:mm:ss CMSINST NSS MAINT 
*NSS fileno NSS A nnnn mm/dd hh:mm:ss HELP NSS MAINT 


18. Redefine your storage before you continue: 


define storage l6ém 

STORAGE = 16M 

Storage cleared - system reset 
ip] cms @ 

VM/XA CMS 5.5 mm/dd/yy hh:mm 
a 

SYNONYM SYN 

CP TERM MODE VM 

Ready; T=n.nn/n.nn hh:mm:ss 
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Step 20. Back Up the Named Saved Systems 


1. Use the procedure in Step 29 of Chapter 2, “Installing VM/XA System Product Release 2 with the 
Starter System (First Level)” to back up the new CMS and CMSXA named saved systems. 


MAP 0013: What to Do Next 
001 


You have finished the service procedure for CMS. 


Are you also servicing CP? 
Yes No 


003 


— Go to Chapter 14, “Rebuilding CP after Applying Service” on page 515. 
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Chapter 14. Rebuilding CP after Applying Service 


This chapter describes: 


e A step-by-step procedure for rebuilding CP after applying program update service, corrective service, 
or local service. 


MAP 0014: Should You Be Doing This Now? 
001 


Are you also servicing CMS? 
Yes No 


— Continue with this chapter. 
003 


Have you built CMS? 
Yes No 


— Go to Chapter 13, “Rebuilding CMS after Applying Service” on page 457. 


— Continue with this chapter. 
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Step 1. Preparation 


1. Establish the appropriate minidisk access order: 


setup Hi 
Ready; T=n.nn/n.nn hh:mm:ss 


ddr @ 


VM/XA SYSTEM PRODUCT DASD DUMP RESTORE PROGRAM 
ENTER CARD READER ADDRESS OR CONTROL STATEMENTS. 


ENTER: 


sysprint cons Hf 
ENTER: 


input 190 devtype MNT190 @ 
ENTER: 


output 490 devtype MNT490 & 
ENTER: 


copy 900 endcyl @ 


DMKDDR711R Volid Read is MNT190. Do you 
wish to continue? 

yes 

ENTER NEXT EXTENT OR NULL LINE: 

x 


END OF COPY 
ENTER: 

| 

END OF JOB 


Installation and Service 


2. Use the DASD DUMP Restore program to copy the current CMS BUILD! disk to its corresponding 
alternate disk. | 


190 is your current CMS system disk. devtype 
is the device type of the DASD volume where 
190 is located. 


490 is your alternate CMS system disk. 


1 , fF tha THACTY Taser 
devtyne is the device type of the DASD volume 


where 490 is located. 


The value for endcyl depends on the device 
type of your 190 disk: 


Device Type endcyl 


3350 73 
3375 112 
3380 71 


You have not yet changed the label of the 490 
minidisk. (You will do so in substep 3 on 
page 517.) 


dine 


3. Relabel the 490 minidisk: 


access 490 t & 

Ready; T=n.nn/n.nn hh:mm:ss 
format 490 t (label & 
ENTER LABEL: 

mnt490 

Ready; T=n.nn/n.nn hh:mm:ss 


Access 490 after the system disk. You must 
use the label option. If you don’t, you will 


erase all the files on the 490 minidisk. 
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Step 2. Build a New CP Macro Library 


1. Establish the appropriate minidisk access order: 


setup @ 
Ready; T=n.nn/n.nn hh:mm:ss 
vnfsetup 56643082 cp (bld @ 
DMSWSU1900W The existing 56643082 $SETUP Al file 
has been refreshed. You might want to 
check your access order when done. 
Ready(0004); T=n.nn/n.nn hh:mm:ss 


| Program Update Service Only | 


2. If you are processing program update service, erase CPNEW MACLIB if it exists. Do not erase CPNEW 
MACLIB if you are processing corrective service or local service. 


erase cpnew maclib fm @ 
Ready; T=n.nn/n.nn hh:mm:ss 


eer eee End of Program Update Service Only poe ie ee ee ee 


Do the rest of this step if: 


¢ One of these conditions applies: 


You are processing program update service and have local modifications 
to CP macros or control blocks 

You are processing corrective service 

You are processing local service. 


3. Access 295 as A: 
access 295 a 


4. Find out which macros and control blocks have been updated by IBM. First list all the CP updates you 
received from IBM: 


listfile * H*HP fm (EXEC @ The updates are on the CP alternate LOCALI 
rename cms EXEC a cpupdate = = Mf (295) disk if you are applying corrective service 
xedit cpupdate EXEC @ or on the CP alternate DELTA (594) disk if 
sort * 150 @ you are applying program update service. You 
file @ may also have updates on other disks in the 


LOCAL! string. 


The EXEC option saves the list in a file called 
CMS EXEC. Any previously existing CMS 
EXEC on your A-disk is erased. 


518 Installation and Service 


foo™ 


. Find out which of the updates you received affect macros and control blocks. At the same time, note 
where those macros and control blocks are. The source files for macros and control blocks should be on 
the CP BASE2 disk (394). For each update listed in CPUPDATE EXEC, issue: 


listfile fn macro * @ If the update affects a macro or control block 
Ready; T=n.nn/n.nn hh:mm:ss file, that file will be listed. | 

listfile fn copy * # 

Ready; T=n.nn/n.nn hh:mm:ss 


. Create or edit an EXEC called CPNEW EXEC to generate a macro library for updated macros. It 
should have the same format as HCPXA1 EXEC, and should list: 


e For program update service, only those macros and control blocks for which you have received 
service and for which you also have local modifications 


e For corrective service, all macros and control blocks for which you have received service, plus any 
for which you have local modifications 


¢ For local service, all macros and control blocks for which you have local modifications. 


If you have no macros or control block files that must be listed in CPNEW EXEC, go to substep 12 on 
page 520. 


a. If you have not already created CPNEW EXEC, issue: 

copy hcpxal EXEC fm cpnew = a (recfm f Irecl 80 @ 

b. If you already have a copy of CPNEW EXEC, issue: 

copy cpnew EXEC fm = = a (recfm f Irecl 80 & 
Now edit CPNEW EXEC, adding all necessary macro and control block names. If you created CPNEW 
EXEC by copying HCPXAI EXEC, use the contents of HCPXA1 EXEC only as a guide to the format 
of the macro entries. After you have added the macros and control block names you need, in the proper 
format, delete the macro names that came from HCPXA1 EXEC. 

xedit cpnew EXEC a Hf 

file @ 
. You now need to copy every macro and control block file listed in CPNEW EXEC to your A-disk. 


copy fn macro fm = = a (olddate replace @ 
copy fn copy fm = = a (olddate replace 


. Generate the new macro library by using the VMFMAC EXEC: 


vmfmac cpnew hcpxa 
DMSUPD178I Updating macroname MACRO Al 
DMSUPD178I Applying macroname update Al 
macroname MACRO ADDED 


Ready; T=n.nn/n.nn hh:mm:ss 
Note: An alternate method to using the VMFMAC EXEC is to update the control blocks and macros 


by using the UPDATE module and issuing MACLIB DELETE and then MACLIB ADD 
commands for the MACLIB containing the changed macro or control block. 


See VM/XA SP CMS Command Reference for details on the MACLIB command. 
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9. The new macro library is now on your A-disk a You can now erase CPNEW COPY (a file created 
by VMFMAC) from the 295 disk. 


erase cpnew copy a & 


10. Add the new macro library name to the TEXT MACS card in the HCPXA CNTRL file. Make it the 
first macro library listed so that you use the updated macros. 


xedit hcpxa cntrl @ 
locate/TEXT MACS @ 

TEXT MACS HCPXAI1 ... 
change/MACS/MACS CPNEW/ @ 
TEXT MACS CPNEW HCPXA1 ... 
file @ 


11. If you want to make the new macro library available to general users, copy it to the alternate CMS 
BUILD! disk (490): 


copy cpnew maclib a = = r2 (olddate replace B 
12. Reaccess 295 as B and 191 as A: 


access 295 b H 
access 191 a @ 


| | If you have any image library updates, refer to VM/XA SP Planning and | 


Administration. 
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Step 3. Update the CP Message Repository 


Do this step if: 


e You are processing program update service and have local modifications to 
the CP message repository 

¢ You are processing corrective service and have local modifications to the CP 
message repository 

¢ You are processing local service. 


1. Determine your system default national language: 
query lang 
P ae langid See Table 5 on page 317 to identify the 
( language corresponding to /angid. Note the 
country code for that language. 


2. Invoke the VMFNLS EXEC to update the CP message repository: 


vmfnis hcpmesy repos 56643082 cp @ y is the country code for your system national 
Ready; T=n.nn/n.nn hh:mm:ss language. 


. 3. If you have updates to the message repositories for any other national languages installed on your 
( “8 system, repeat substep 2 for each language. 
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Step 4. Assemble the Changed ASSEMBLE Files 


1. Establish the correct minidisk access order: 


setup & 
vmfsetup 56643082 cp (all @ 


2. Determine which ASSEMBLE files you must reassemble: 


¢ Although you will not receive any updates affecting HCPRIO ASSEMBLE or HCPSYS 
ASSEMBLE, you must reassemble these files. 


| | ¢ Review the apply exception log (SVMFAPP $ERRLOG) for the names of ASSEMBLE files to which 
7 | you have applied service and for which you also have local updates. You decided in Chapter 11, 
| | “Applying Program Update Service or Corrective Service to CMS” on page 449 which of these local 
| updates you wish to keep. 


vmfview apply @ To find these ASSEMBLE files, search for all a 
instances of message DMSxxx1885W. This SY 
message lists all the MACRO, COPY, EXEC, aa 


updates. You must reassemble any such 


| 

| 

| 

| and ASSEMBLE files for which you have local 
| 

| ASSEMBLE files to pick up the local updates. 


oo 
ee | 
3. Copy and unpack each ASSEMBLE file to be reassembled. You must do this because the UPDATE Ne 
module requires unpacked files, and they are packed on the 394 disk, where they are stored. 
copy hcpxxx assemble * = = a (unpack olddate @ Substitute the last three characters of the 
filename of the ASSEMBLE file for xxx. 
4. Use the VMFHASM EXEC to update and assemble all the files that need reassembling: 
vmfhasm hepxxx 56643082 cp @ Substitute the last three characters of the ane 
Ready; T=n.nn/n.nn hh:mm:ss , filename of the ASSEMBLE file for xxx. ff \ 


The text file created will be placed on the 
A-disk. 


5. Copy all the text files from the A-disk to the alternate LOCALI1 (295) disk: 
copy hcpxxx {text|xxxnnnnn} a==b @ 


6. If you reassembled any files that are not in the CP load list, copy the text decks to the alternate a 
disk again, giving the copy the filetype TEXT: 


copy hcpxxx {text|xxxnnnnn} a = text b Hf 
7. Erase all the ASSEMBLE files and text files from your A-disk: 


erase hcpxxx assemble a Ml CC 
erase hcpxxx {text|xxxnnnnn\ a 


8. Repeat substeps 3 through 7 for each file that must be reassembled. 
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Step 5. Build the CP Nucleus 


If you have received corrective service for, or have local modifications to, 
HCPLDL ASSEMBLE or the HCPMDLAT macro, you must issue UTILITY 


CPLOAD to rebuild the CPLOAD EXEC before you build the nucleus. See 
Step 8 for more details. 


1. Make a backup copy of your system, using the DASD dump restore program. 


2. Define storage as 16 megabytes and IPL your system disk: 


define storage l6m 
STORAGE = 16M 


STORAGE CLEARED - SYSTEM RESET 


ip] sysaddr @ 
VM/XA CMS 5.5 mm/dd/yy hh:mm 


LO 
Ready; T=n.nn/n.nn hh:mm:ss 
3. Establish the appropriate minidisk access order: 


setup Mi 


4. Invoke the VMFBLD EXEC to build a new CP nucleus. 


spool punch * class n @ 
spool prt * Hf 

spool rdr class n &@ 

spool rdr hold @ 

vnfbld 56643082 cp (punch @ 


or 


vmfbid 56643082 corcp (punch @ 

DMSBLD1851I Processing CPLOAD with the part 
handler VMFBDNUC EXEC 

LOAD LIST: $$$TLL$$ EXEC Al (MNT191) 


Defining storage causes a system reset. 


sysaddr is your system disk address, either 190 
or 490. 


After receiving the version identification, press 
ENTER 


If you are processing PUT service, use cp as 
the component name. 


If you are processing COR service, use corcp as 
the component name. 


(To ensure that text decks are copied to the 
correct disk during VMFBLD execution using 
VMFBDCPY, the component name for CP 
corrective service is now corep. This causes the 
corrective service override to be applied to the 
56643082 $PPF and the DELTA disk string to 
be redefined). 


RDR FILE fileno SENT FROM MAINT PUN AS fileno RECS nnnn COPY 001 N NOHOLD NOKEEP 


The system loader punches the CP nucleus. 
This message tells you that the punch file is 
complete. 
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Ready; T=n.nn/n.nn hh:mm:ss If you get return code 4, the reason may be 
that a PTF which is now being applied has 
another PTF, outside CP, as a prerequisite. 
Check the $VMFBLD $ERRLOG file for 

\ message DMSBNC1854W. | 


| 5. Review the build exception log (SVMFBLD $ERRLOG). If necessary, correct any problems before 
| going on. 


| vmfview build Mf 
6. Make sure that the files created in the previous substep are in MAINT’s virtual reader. 


query rdr maint all class n @ The ALL operand asks for a display of all 
information about the reader files. 


ee ee a eT me ST Oe ee ed 


T 
MAINT nnnn N PUN nnonnnnnn 001 USER mm/dd hh:mm:ss $$$TLL$$ IPL YSPROG MO? 
Ready (0004); T=n.nn/n.nn hh:mm:ss - 


Perform the next two substeps only if you are generating a CP nucleus with a 
preferred virtual machine. 


7. Precautions must be taken if the new CP nucleus is to contain a V=R area (including V=F storage) but 
you are not ready to load (IPL) the new nucleus. If the V=R guest is running a job, then let it finish its 


re 


ORIGINID FILE CLASS RECORDS CPY HOLD DATE TIME NAME TYPE p 
S 


present work and do not allow more work to begin. The reason for this precaution is that V=R recovery e - 
may fail in the event of a system restart. Ne” 
8. Find out how much virtual storage MAINT has and define more if necessary. If you are generating a 
CP nucleus with a preferred virtual machine, MAINT’s virtual storage must be at least 4 megabytes 
greater than that specified by the VRSIZE operand plus that specified by the VRFREE operand in the 
SYSSTORE macro instruction in HCPSYS ASSEMBLE. 
vmfsetup 56643082 cp (all Mf 
Ready; T=n.nn/n.nn hh:mm:ss | | oo 
xedit hcpsys assemble @ Check the size of the VRSIZE and VRFREE 
: operands. 
locate /VRSIZE @ 
qquit @ 
Ready; T=n.nn/n.nn hh:mm:ss 
query virtual storage @ 
STORAGE = nnnnM 
define storage nono & 
STORAGE = nnnnM --—- You will re-IPL CMS in substep 14 on 


STORAGE CLEARED - SYSTEM RESET | page 526, so you do not have to do it now. 
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9. If you are using the starter system defaults, issue the following commands to make sure that the new 
nucleus does not overlay the production nucleus on the system residence volume while your system is in 


production. 


set machine 370 & 
Ready; T=n.nn/n.nn hh:mm:ss 


cpformat 423 xasres 000-endcyl Hf 

CPFORMAT: 

FORMAT WILL ERASE CYLINDERS 0000-0009 ON DISK 423 
DO YOU WANT TO CONTINUE ? (YES | NO) 

yes 

FORMAT STARTED 

FORMAT COMPLETE 

CURRENT ALLOCATION 

TYPE CYLINDERS 


PERM 0000-endcyl 
> | ENTER ALLOCATION DATA 
TYPE CYLINDERS 


— end & 
( CURRENT ALLOCATION 
te TYPE CYLINDERS 
PERM 0000-endcyl 
ALLOCATE COMPLETE 
VOLUME LABEL IS NOW 'XASRES' 
HCPFAM3841 CPFORMAT COMPLETE 
SYSTEM RESET 


( define 123 nnn & 
a DASD nnn DEFINED 
Ready; T=n.nn/n.nn hh:mm:ss 


define 423 123 @ 
| DASD 0123 DEFINED 
i Ready; T=n.nn/n.nn hh:mm:ss 


define nnn 423 @ 
DASD 0423 DEFINED 
Ready; T=n.nn/n.nn hh:mm:ss 


set machine xa 


CPFORMAT the 423 minidisk with label 
XASRES. 


The value of endcyl depends on two things: 
the DASD type and whether you are are using 
the 423 minidisk defined in the sample 
directory, or a full-pack minidisk that you 
have defined on a second XASRES volume. 


endcyl for endcyl for 
Device Type Sample 423 Full-Pack 423 


3350 0012 0554 
3375 0015 0958 
3380 0009 0884 
3380-E4 0009 | 1769 
3380-K 0009 2654 


Allocate the whole area as PERM. 


nnn is any address you are not using. 


Define the 423 minidisk as virtual 123. This is 
the default address for the system residence 
volume. 


Define the a backup pack for the system 
residence volume. This is your old 123 
minidisk. 


10. You must perform this substep if you redefined MAINT’s virtual storage as greater than 16 megabytes. 


Storage addresses greater than 16 megabytes 
require 370/XA architecture. 
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11. Load IPL) MAINT’s virtual reader. 


ip] 00c @ 


MSG FROM MAINT 

HCPGEN9O10W NUCLEUS LOADED ON XASRES 
CP ENTERED; DISABLED WAIT 

PSW OQOAD00O 00009010 


The 9010 disabled wait state indicates that the 
CP nucleus is successfully loaded on the system 
residence device. If you receive a different 
disabled wait state code, see VM/XA SP 


System Messages and Codes Reference. 


If you entered a disabled wait state with a code 
8028, you did not observe the warning notes 
dealing with virtual storage size in the substeps 
above. 


12. You have now loaded the nucleus to MAINT’s 423 disk. (This is also the test 123 minidisk, labeled 
MNT123.) If you are using the starter system defaults, this is a holding area for the new nucleus. 


fo 
13. Issue the following commands to review the CP nucleus map for errors. _ J 
set machine 370 
define storage lém H 
14. Save the CP load map. 
a. The load map has been spooled to MAINT’s virtual printer. To save the load map on MAINT’s 
LOCAL]1 (0295) minidisk: 
spool prt nohold @ | ( ) 
close prt @ / 
ip] sysaddr @ sysaddr is your CMS system disk, either 190 or 
490. 
b. When VM READ appears in the corner of your screen, continue: 
a aa 
CMS VS 
Me 


setup # 

Ready; T=n.nn/n.nn hh:mm:ss 
access 295 b & 

Ready; T=n.nn/n.nn hh:mm:ss 
query rdr * all @ 


OWNERID FILE CLASS RECORDS CPY HOLD USERFORM OPERFORM KEEP MSG 
MAINT fileno A PRT nnnnnnnn 001 NONE STANDARD STANDARD OFF OFF 
Note the fileno in this message. You will use it 


in your next command. 


This command saves the load map on 
MAINT’s LOCAL 1 (0295) minidisk. 


receive fileno cpnuc map b (replace @ 
Ready; T=n.nn/n.nn hh:mm:ss 
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c. To print a copy of the load map for the CP nucleus: 


print cpnuc map b The load map is printed on your system 
Ready; T=n.nn/n.nn hh:mm:ss printer. 


15. Redefine your nucleus areas at their original addresses. 


define 423 nnn @ 
DASD nnn DEFINED 
Ready; T=n.nn/n.nn hh:mm:ss 
define 123 423 @ 
DASD 0423 DEFINED 
Ready; T=n.nn/n.nn hh:mm:ss 
define nnn 123 @ | 
DASD 0123 DEFINED 
Ready; T=n.nn/n.nn hh:mm:ss 


( ; 16. Test your new nucleus. 
, a. Use the IPL DDRXA utility with the DUMP NUC option to dump the nucleus on 123 to tape. 
b. Define your test XASRES volume as virtual 4A0. (If you use the sample HCPRIO in this book, you 


cannot use address 123 because that address is defined as a console.) 


detach 0123 @ nnnn is the address of your test XASRES 

define 423 04A0 volume. The load deck should still be in your 
reader, since you have spooled it with the 
HOLD operand in a previous step. 


( ae c. Set your virtual machine in XA mode and define your console at a valid virtual address in the 
HCPRIO file: 


set machine xa &@ 
Ready; T=n.nn/n.nn hh:mm:ss 


query cons @ 
CONS vdevno ... 


pe. define vdevno 0020 @ 
( term conmode 3270 
d. IPL your test XASRES volume at second level. Do not perform a hardware IPL. 


ip] 4A0 clear @ 


i Press ENTER to create an interrupt. 


If you can IPL your test XASRES volume successfully, continue with Step 6. 


Note: You may need to define some temporary spool and paging space. 
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Step 6. Test the CP Nucleus 


Warning: You can do this step only if your test KASRES volume is a 
full-pack minidisk. If you are using a 10-cylinder minidisk, the only testing 
you can do is verifying that you can load the nucleus onto the test 423 


minidisk. You did this when you [PLed your test XASRES in Step 5. Go to 
Step 7. 


Now that you have applied service to all necessary parts, you should test the 
system to make sure that the problem has been fixed. 
1. Test your system at second level. If it performs to your satisfaction, do “Step 7. Put the New CP 


System into Production” on page 529. If the system fails, do not do Step 7. Find out what went wrong 
and start over with a new fix. 
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Step 7. Put the New CP System into Production 


1. Shut down your second-level system. A Class A user (usually the primary system operator) must issue 


the SHUTDOWN command. 


shutdown 

SYSTEM SHUTDOWN STARTED 

SYSTEM WARM START DATA SAVED 

SYSTEM SHUTDOWN COMPLETE 

HCPGIR450W CP ENTERED; DISABLED WAIT 
PSW OOOAD000 00000961 


2. Link to your production-level XASRES pack in read/write mode: 


#cp link * 123 123 mr @ 
Ready; T=n.nn/n.nn hh:mm:ss 


3. Load (IPL) MAINT’s virtual reader: 


ip! 00c clear @ 


hh:mm:ss * MSG FROM MAINT 
HCPGEN9O10W NUCLEUS LOADED ON XASRES 
HCPGIR450W CP ENTERED; DISABLED WAIT 
PSW OGOAD000 00009010 


The 9010 disabled wait state indicates that the 
CP nucleus is successfully loaded on the system 
residence device. 


If you enter a disabled wait state with a code 
691, you did not observe the warning notes 
above. 


If you receive a different disabled wait state 
code, see VM/XA SP System Messages and 
Codes Reference. 
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Step 8. Build Utilities | 


Do this step if: 


e You are processing program update service and have local modifications to 
utilities 

e You are processing corrective service 

e You are processing local service. 


1. IPL 190: 


ip! 190 clear @ 
VM/XA CMS 5.5 mm/dd/yy hh:mn 
z 


2. Establish the appropriate minidisk access order: 


setup Mi 
vmfsetup 56643082 cp (bid @ 


3. Determine whether you have to build any utilities. 


e If you are processing corrective service, make and sort a list of the files you are servicing: 


listfile hcp* text b (EXEC label @ The EXEC option saves the list in a file called 
rename cms EXEC a hentext = = @ CMS EXEC. Any previously existing CMS 
xedit hcptext EXEC EXEC on your A-disk is erased. 

sort * 150 @ 

file 


Check the whole list against Table 13 on page 531. You must use UTILITY to build any file you. 
find listed there. 


e If you are processing program update service, use VMF VIEW to examine $VMFAPP $ERRLOG for 
files that have both IBM service and local modifications. Such files are identified by message 
DMSAPPI1885W. Check these files against Table 13 on page 531. You must use UTILITY to build 
any file you find listed there. 


4. For each file in the first column of Table 13 on page 531, type the line printed in the second column. 


The UTILITY EXEC builds the utilities on the 
A-disk (0295). 


access 295 a 

Ready; T=n.nn/n.nn hh:mm:ss 
utility gen filename B 
Ready; T=n.nn/n.nn hh:mm:ss 


530 Installation and Service 


Table 13. UTILITY GEN Commands 


Assemble File 
Name Command to Type In File Created by this Command 


Note: If you receive service for a CP TEXT deck not listed in this table, it will be regenerated in some 
other way. You do not need to regenerate it now. (See Table 16 on page 595 in Appendix A, 


“VM/XA System Product Regeneration Requirements” for the procedure used. Text decks not 
listed in this table or in Table 16 on page 595 will become part of the nucleus when the system is 
built if they are listed in the CP load list.) 


HCPBSL utility gen 3card loader & 3CARD LOADER 
HCPCCF, utility gen cpfmtxa @ CPFMTXA MODULE 
HCPFAx, 
HCPFON 
HCPCCU utility gen hepccu @ HCPCCU MODULE 
a | HCPDDC, utility gen ipl ddrxa @ IPL DDRXA 
( : HCPDDR, 


HCPDDT, 
HCPDNC, 
HCPDNT 


HCPDIR utility gen directxa @ DIRECTXA MODULE 
directxa user direct Hf 


HCPEDx utility gen dumpload @ DUMPLOAD MODULE 
ay HCPIFC utility gen cperepxa Ml CPEREPXA MODULE 
( 7 y HCPIMG utility gen genimage Mf GENIMAGE MODULE 


HCPLDL, utility cpload @ CPLOAD EXEC 
HCPMDLAT 
HCPLDR utility gen hepldr @ HCPLDR MODULE 
HCPMOW utility gen monwrite & MONWRITE MODULE 
HCPNMT utility gen imagelib & IMAGELIB MODULE 
| | HCPOVE utility gen override Hf OVERRIDE MODULE 

( ; HCPRET utility gen retrieve & RETRIEVE MODULE 

HCPSADMP utility gen hcpsadmp @ HCPSADMP MODULE 


5. Test the utilities. 
6. Copy the regenerated utilities from the A-disk to the CMS alternate BUILD1 (R-disk): 


access 490 r @ 
Ready; T=n.nn/n.nn hh:mm:ss 
copy fn ft a = = r2 (olddate replace @ ft can be MODULE, EXEC, LOADER, or 


Ready; T=n.nn/n.nn hh:mm:ss DDRXA (see Table 13). 


7. Erase the utilities from LOCAL! (295) if they are not compatible with the utilities on the running S-disk. 
The Memo to Users will tell you whether or not they are compatible. 


8. Repeat substeps 4 on page 530 through 7 for each utility. 
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9. IPL your system disk: 


532 


ip] 199 & 

VM/XA CMS 5.5 mm/dd/yy hh:mm 
a 

Ready; T=n.nn/n.nn hh:mm:ss 
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NG of 


Step 9. Regenerate System Product Interpreter Programs 


Do this step if: 


e You are processing program update service and have local modifications to 
System Product Interpreter programs (EXECs and XEDIT macros and the 
~ $DASDS CONSTS file) 
e You are processing corrective service 
¢ You are processing local service. 


1. Establish the appropriate minidisk access order: 


setup @ 
vmfsetup 56643082 cp (bld @ 


2. Determine whether you have received service for any System Product Interpreter programs (EXECs or 


XEDIT macros and the $DASD$ CONSTS file): 


listfile * EXEC fm (EXEC @ The updates are on the CP alternate LOCALI 
rename cms EXEC a execfix = = # (295) disk if you are applying corrective service 
listfile * XEDIT fm (EXEC @ or on the CP alternate DELTA (594) disk if 
rename cms EXEC a xeditfix = = Mf you are applying program update service. 
listfile $DASD$ CONSTS fm (EXEC @ , baaes 

rename cms EXEC a dasdfix = = & The EXEC option saves the list in a file called 


CMS EXEC. Any previously existing CMS 
EXEC on your A-disk is erased. 


. Examine the list of EXECs and XEDIT macros to which you have applied service and determine if you 


have local modifications (including corrective service not included on the PUT you are processing) for 
any of them. 


Warning: The $VMFAPP $ERRLOG file will not identify these EXECs and XEDIT macros for you. 
You must know what local modifications you have made. 


. Copy the latest version of the base code for each EXEC or XEDIT macro for which you have both IBM 


service and local modifications to the CP alternate LOCALI disk (295). 


copy fn {$EXEC|$XEDIT|$CONSTS! fm = =b @ 


. Regenerate any EXECs or XEDIT macros for which you have received service and for which you have 


local modifications: 


execupdt fn ft b (ctl hcpxa options @ ft is EXEC, XEDIT, or CONSTS, without the 
dollar sign. HCPXA is the CP control 
filename. 


For any files with a SID code in columns 63 
through 71, use the HIST and SID options. 
For all other files, use only the HIST option. 


6. Erase the base code from the CP second alternate LOCAL] disk: 


erase fn {$EXEC|$XEDIT|$CONSTS} b Mf 


7. Repeat substeps 4 through 6 for each System Product Interpreter program that needs regenerating. 
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8. For each EXEC or XEDIT macro for which you received service, whether you regenerated it or not, 
check to see if the original EXEC or XEDIT macro was on MAINT’s 490 disk: 


listfile fn ft r @ 


9. If the replaced or updated EXEC or XEDIT macro belongs on MAINT’s 490 disk, copy it there: 


copy fn ft fm = = r2 (olddate replace M@ The macros are on the alternate LOCAL] 

Ready; T=n.nn/n.nn hh:mm:ss (295) disk if you are applying corrective service 
or on the alternate DELTA (594) disk if you 
are applying program update service. 
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Step 10. Test and Rebuild CMS 


1. Perform Steps 10, 13, 15, 16, and 17 of Chapter 13, “Rebuilding CMS after Applying Service” on 
page 457 to make the files on the 490 disk available to users. 
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Step 11. Back Up the CP System 


1. Use the procedure in Step 30 of Chapter. 2, “Installing VM/XA System Product Release 2 with the 
Starter System (First Level)” to back up your new CP system. 


ae _ This is the end of the service procedure for CP. 4 
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Chapter 15. Program Update Service or Corrective Service to 
the Dump Viewing Facility 


This chapter describes: 


e Receiving program update service or corrective service for the dump viewing facility 


e Applying program update service or corrective service to the dump viewing facility 


¢ Rebuilding the dump viewing facility. 


Step 1. Preparation 


2 1. Establish the appropriate minidisk access order: If you have not yet examined the SETUP EXEC and 
created your own version if necessary, turn to page 435 and do so now. 


| setup 
| Ready; T=n.nn/n.nn hh:mm:ss 


2. Use the DASD DUMP Restore program to copy the current CMS BUILD! disk to its corresponding 
alternate disk. 


—— ddr & 
( VM/XA SYSTEM PRODUCT DASD DUMP RESTORE PROGRAM 
ENTER CARD READER ADDRESS OR CONTROL STATEMENTS. 
ENTER: 
sysprint cons @ This command tells DDR to send program 
ENTER: messages to your console. 
( input 190 devtype MNT190 @ 190 is your current CMS system disk. devtype 
_ ENTER: is the device type of the DASD volume where 
190 is located. 
output 490 devtype MNT490 @ 490 is your alternate CMS system disk. 
ENTER: devtype is the device type of the DASD volume 
where 490 is located. 
copy 000 endcyl @ The value for endcyl depends on the device 


type of your 190 disk: 
Device Type endcyl 


3350 73 
3315 112 
3380 Ti 
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DMKDDR711R Volid Read is MNT190. 
wish to continue? 

yes 

ENTER NEXT EXTENT OR NULL LINE: 

= | : 


END OF COPY 
ENTER: 

ez 

END OF JOB 


3. Relabel the 490 minidisk: 
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access 490 t 

Ready; T=n.nn/n.nn hh:mm:ss 
format 490 t (label Hf 
ENTER LABEL: 

mt490 @ 

Ready; T=n.nn/n.nn hh:mm:ss 
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Do you 


You have not yet changed the label of the 490 
minidisk. (You will do so in substep 3 on 
page 538.) 


Access 490 after the system disk. You must 
use the label option. If you don’t, you will 
erase all the files on the 490 minidisk. 


ie : 


Step 2. Receive Service 


Before You Receive Service 


If you are not familiar with the new options provided in the VMFREC EXEC with the addition of 
APAR VM37518, refer to “WMFREC EXEC” on page 709. In particular, the section “Usage Notes” on 
page 710 describes considerations for using the TASK disk string to establish a separate disk string for 
the service EXECs. 


1. Establish the appropriate minidisk access order: 


setup @ 
Ready; T=n.nn/n.nn hh:mm:ss 


release c VMFREC INFO (MEMOS xxx loads 

Ready; T=n.nn/n.nn hh:mm:ss documents to your C-disk if it is accessed, 
otherwise to your A-disk. You want them on 
your A-disk. 


2. Attach a tape drive to MAINT: 
attach vdevno * 181 & 


3. Mount and ready the service tape. 


4. Get the PUT or COR documentation and map the tape: 


vmfrec info (memos xxx Mi xxx is put if you are applying program update 
DMSREC1851I This is n of n service, cor if you are applying corrective 
level level {PUT|COR} tape service. If the tape you mounted is not the 
kind of tape you specified, you receive an error 
message. 


VMFREC INFO (MEMOS maps the tape 
and loads the tape map, the PUT document or 
COR document, and the Memo to Users to 
your A-disk. Read these documents before 
going on. 


If your system default language is uppercase 
American English, you may get message P 
DMSMGMS8I14E. This message is caused by a 
problem with the REXX date function. You 

can ignore it. 


5. VMFREC may tell you that the level of service EXECs on the tape is different than the level of service 
EXECs on your system. Refer to the “Usage Notes” section of the VMFREC EXEC description (on 
page 710) for information on receiving a new level of the service EXECs. 


e If you have not made any local modifications to the old product parameter file, you can use the new 
file as it stands. Go on to the next step. | 


e If you had any local modifications in the old product parameter file, your override file should be on 
the CMS LOCAL] disk string. Look at the new product parameter file on the 191 disk to see 
whether any changes from the last IBM-supplied product parameter file affect your override file. If 
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you are applying corrective service, be sure to include the changes oF the corrective service 
override section of the base file in your override file. : 


The product parameter file has three sections for each component: 


a. Control options 
b. Minidisk assignments 
c. EXECs needed to update each part of the product. 


You may change the first two sections to suit your installation, but it is not recommended that you 
change the EXEC section. 3 


Always place changes in an override file. Do not change the base product parameter file. 


After you have made any necessary changes in your own override file, copy it to the 191 disk with 
the REPLACE option. 


For more information about the product parameter file, see “The Product Parameter File” on page 401. 


6. Receive the service files: 


vmfrec 56643082 dv (xxx Mf | xxx 1S put if you are applying program update | ‘ ; 
service, cor if you are applying corrective ae ae 
service. 
DMSREC18511 This is n of n 
level level {PUT|COR} tape 
DMSREC1869R 56643082 DV begins on {PUT|COR} If you do not have the correct volume fos 
level volume vol. Mount mounted, mount it now. Me y 
correct volume and press ENTER 
or type QUIT. | 
ie 
DMSREC1851I This is n of n 
level level {PUT|COR} tape 
DMSREC1086I The current Service Diskmap contains 
the map of the mounted tape. 
DMSREC1804I Receiving service for component DV of product 
56643082 —_ 
DMSREC18511I Processing parttype with the part handler wo 


parthandler EXEC 
Ready; T=n.nn/n.nn hh:mm:ss 


7. Review the receive exception log (SVMFREC $ERRLOG). If necessary, correct any problems before 
going on. 


vnfview receive 
Ready; T=n.nn/n.nn hh:mm:ss 
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Step 3. Apply the Updates 


1. Establish the appropriate minidisk access order: 
setup Hi 
2. Apply the updates: 
vmfapply 56643082 dv (xxx 
DMSAPP18531I Processing PTF ptfnum 
DMSAPP18511I Processing partname parttype with 
the part handler fn EXEC 


Ready; T=n.nn/n.nn hh:mm:ss 


3. Review the apply exception log (SVMFAPP $ERRLOG). 
going on. 


vmfview apply Mf 


xxx is put if you are applying program update 
service, cor if you are applying corrective 
service. 


If necessary, correct any problems before 
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Step 4. Build the Dump Viewing Facility 
1. Establish the appropriate minidisk access order: 


setup faa 
vmfsetup 56643082 dv (bld @ 


2. Build the dump viewing facility: 
utility dvfgend all @ 


3. Copy all MODULE files created by UTILITY DVFGEND ALL to the BUILD1 disk (490), then erase 
them from your A-disk. 


copy fn module a = = m2 @ 
Ready; T=n.nn/n.nn hh:mm:ss 
erase fn module a @ 


4. Copy all MAP files created by UTILITY DVFGEND ALL to the APPLY disk (692) for program 
update service or the alternate LOCAL] disk (395) for corrective service, then erase them from your 
A-disk. 


copy fn map a = = fm 
Ready; T=n.nn/n.nn hh:mm:ss 
erase fn map a Mf 


5. Copy DVF interface files to the CMS system disk: 


vmfbid 56643082 dv If you are processing PUT service, use dv as 
me the component name. 
vmfbld 56643082 cordv If you are processing COR service, use cordv as 


the component name. 


(To ensure that text decks are copied to the 
correct disk during VMFBLD execution using 
VMFBDCPY, cordv is now the component 
name for DV corrective service. This causes 
the corrective service override to be applied to 
the 56643082 $PPF and the DELTA disk 
string to be redefined). 
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Step 5. Regenerate System Product Interpreter Programs 


Do this step if: 


e You are processing program update service and have local modifications to 


System Product Interpreter programs (EXECs and XEDIT macros) 
e¢ You are processing corrective service 
e You are processing local service. 


1. Establish the appropriate minidisk access order: 


setup Mi 
vnfsetup 56643082 dv (bld @ 


2. Determine if you have received service for any System Product Interpreter programs (EXECs or XEDIT 


macros): 

( : listfile * EXEC fm (EXEC @ The updates are on the CMS alternate 
rename cms EXEC a execfix = = @ LOCAL I (395) disk if you are applying 
listfile * XEDIT fm (EXEC @ corrective service or on the CMS alternate 
rename cms EXEC a xeditfix = = Mf DELTA (593) disk if you are applying 

program update service. 
The EXEC option saves the list in a file called 
CMS EXEC. Any previously existing CMS 
| EXEC on your A-disk is erased. 
(_ 3. Examine the list of EXECs and XEDIT macros to which you have applied service and determine if you 
have local modifications (including corrective service not included on the PUT you are processing) for 
any of them. 


Warning: The $VMFAPP $ERRLOG file does not identify these EXECs and XEDIT macros for you. 
You must know what local modifications you have made. 


4. Copy the latest version of the base code for each EXEC or XEDIT macro for which you have both IBM 
service and local modifications to the CMS alternate LOCAL] disk (395). 


( copy fn {$EXEC|$XEDIT} fm == b & 


5. Regenerate any EXECs or XEDIT macros for which you have received service and for which you have 
local modifications: 


execupdt fn ft b (ctl hcsxa options @ ft is EXEC or XEDIT, without the dollar sign. 
HCSXA is the dump viewing facility control 
file name. 


For any files with a SID code in columns 63 
through 71, use the HIST and SID options. 
For all other files, use only the HIST option. 


6. Erase the base code from the CMS alternate LOCAL] disk: 


erase fn {$EXEC|$XEDIT} b @ 


7. Repeat substeps 4 through 6 for each System Product Interpreter program that needs regenerating. 
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8. For each EXEC or XEDIT macro for which you received service, whether you regenerated it or not, 
check to see whether the original EXEC or XEDIT macro was on MAINT’s 490 disk: 


listfile fn ft m 


9. If the replaced or updated EXEC or XEDIT macro belongs on MAINT’s 490 disk, copy it there: 
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copy fn ft fm = = m2 (olddate replace gz 
Ready; T=n.nn/n.nn hh:mm:ss 
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The macros are on the alternate LOCAL] 
(395) disk if you are applying corrective service 
or on the alternate DELTA (593) disk if you 
are applying program update service. 


ve. 
/ 


Step 6. Test and Rebuild CMS 


1. Perform Steps 10, 13, 15, 16, and 17 of Chapter 13, “Rebuilding CMS after Applying Service” on 
page 457 to make the files on the 490 disk available to users. 
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Step 7. Back Up the Dump Viewing Facility 


1. Use the procedure in Step 30 of Chapter 2, “Installing VM/XA System Product Release 2 with the 
Starter System (First Level)” to back up the dump viewing facility. 


P This is the end of the service procedure for the dump viewing facility. ee 
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Chapter 16. Program Update Service or Corrective Service to 


GCS 


This chapter describes: 


¢ Receiving program update service or corrective service for the group control system 


¢ Applying program update service or corrective service to the group control system 


¢ Rebuilding the group control system. 


Step 1. Preparation 


1. Establish the appropriate minidisk access order. If you have not yet examined the SETUP EXEC and 
created your own version if necessary, turn to page 435 and do so now. 


setup @ 
Ready; T=n.nn/n.nn hh:mm:ss 


2. Use the DASD DUMP Restore program to copy the current CMS BUILD1 disk to its corresponding 


alternate disk. 


ddr @ 

VM/XA SYSTEM PRODUCT DASD DUMP RESTORE PROGRAM 
ENTER CARD READER ADDRESS OR CONTROL STATEMENTS. 
ENTER: 


sysprint cons @ 
ENTER: 


input 190 devtype MNT190 @ 
ENTER: 


output 490 devtype MNT490 
ENTER: 


copy 000 endcyl @ 


This command tells DDR to send program 
messages to your console. 


190 is your current CMS system disk. devtype 
is the device type of the DASD volume where 
190 is located. 


490 is your alternate CMS system disk. 
devtype is the device type of the DASD volume 
where 490 1s located. 


The value for endcyl depends on the device 
type of your 190 disk: 


Device Type endcyl 


3350 73 
33/5 112 
3380 71 
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DMKDDR711R Volid Read is MNT190. 
wish to continue? 

yes & 

ENTER NEXT EXTENT OR NULL LINE: 

= 


END OF COPY 
ENTER: 

a 

END OF JOB 


3. Relabel the 490 minidisk: 
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access 490 t @ 

Ready; T=n.nn/n.nn hh:mm:ss 
format 490 t (label @ 
ENTER LABEL: 

mt490 

Ready; T=n.nn/n.nn hh:mm:ss 
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You have not yet changed the label of the 490 
minidisk. (You will do so in substep 3 on 
page 548.) 


Access 490 after the system disk. You must 
use the label option. If you don’t, you will 
erase all the files on the 490 minidisk. 


Step 2. Receive Service 


| Before You Receive Service 


| | If you are not familiar with the new options provided in the VMFREC EXEC with the addition of 

| | APAR VM37518, refer to “VMFREC EXEC” on page 709. In particular, the section “Usage Notes” on 
| | page 710 describes considerations for using the TASK disk string to establish a separate disk string for 

| the service EXECs. 


1. Establish the appropriate minidisk access order: 


setup & 
Ready; T=n.nn/n.nn hh:mm:ss 


fo | release c VMFREC INFO (MEMOS xxx loads 
( | Ready; T=n.nn/n.nn hh:mm:ss documents to your C-disk if it is accessed, 
| otherwise to your A-disk. You want them on 
| your A-disk. 


2. Attach a tape drive to MAINT: 
attach vdevno * 181 @ 


3. Mount and ready the service tape. 


( 4. Get the PUT or COR documentation and map the tape: 


| vmfrec info (memos xxx @ xxx is put if you are applying program update 
| DMSREC1852I This is n of n, service, cor if you are applying corrective 

| level level {PUT|COR} tape service. If the tape you mounted is not the 

| kind of tape you specified, you receive an error 
| message. 


| VMFREC INFO (MEMOS maps the tape 
ne | and loads the tape map, the PUT document or 
( | | COR document, and the Memo to Users to 
. | your A-disk. Read these documents before 
| going on. 


| If your system default language is uppercase 

| American English, you may get message 

| DMSMGMS81]14E. This message is caused by a 
| problem with the REXX date function. You 

| can ignore it. 


| 5. VMFREC may tell you that the level of service EXECs on the tape is different from the level of service 
| EXECs on your system. Refer to the “Usage Notes” section of the VMFREC EXEC description (on 
| page 710) for information on receiving a new level of the service EXECs. 


e If you have not made any local modifications to the old product parameter file, you can use the new 
file as it stands. Go on to the next step. 


( > e If you had any local modifications in the old product parameter file, your override file should be on 
a the CMS LOCAL] disk string. Look at the new product parameter file on the 191 disk to see if any 
changes from the last IBM-supplied product parameter file affect your override file. If you are 
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applying corrective service, be sure to include the changes from the corrective service override section 
of the base file in your override file. 


Bi 
The product parameter file has three sections for each component: (a : 


a. Control options 
b. Minidisk assignments 
c. EXECs needed to update each ear of the product. 


You may change the first two sections to suit your installation, but it is not recommended that you 
change the EXEC section. 


Always place changes in an override file. Do not change the base product parameter file. 


After you have made any necessary changes in your own override file, copy it to the 191 disk with 
the REPLACE option. 


For more information about the product parameter file, see “The Product Parameter File” on page 401. 


6. For each GCS system to which you are applying service, create a product parameter override file using 
an alternate name for the system; for example, ALTGCS. Add the alternate name to the :OVERLST. 


tag. Specify the appropriate load list name after the :BLD. tag. Be sure to include any overrides from c _ 
the :CORGCS. section of the base product parameter file. No? 
7. Receive the service files: 
vmfrec 56643082 gcs (xxx xxx is put if you are applying program update 
service, cor if you are applying corrective 
service. 
DMSREC1852I This is n of n, a 
level level {PUT|COR} tape | a, 
DMSREC1806I The current Service Diskmap contains 
the map of the mounted tape 
DMSREC1869R 56643082 GCS begins on {PUT|COR} If you do not have the correct volume 
level volume vol. Mount mounted, mount it now. 
correct volume and press ENTER or type QUIT. 
| | 
DMSREC1852I This is n of a, _ 
level level {PUT|COR} tape | Se 7 


DMSREC1806I The current Service Diskmap contains 
the map of the mounted tape 

DMSREC18041I Receiving service for component GCS 
of product 56643082 

DMSREC18511 Processing parttype with the part handler 
parthandler EXEC 


Ready; T=n.nn/n.nn hh:mm:ss 


8. Review the receive exception log (GSVMFREC $ERRLOG). If necessary, correct any problems before 
going on. 


vnfview receive | 
Ready; T=n.nn/n.nn hh:mm:ss 
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Step 3. Apply the Updates 


1. Establish the appropriate minidisk access order: 


setup 


2. Apply the updates: 


vmfapply 56643082 gcs (xxx @ xxx is put if you are applying program update 
DMSAPP1853I Processing PTF ptfnum service, cor if you are applying corrective 
DMSAPP1851I Processing partname parttype with service. 


the part handler fn EXEC 
Ready; T=n.nn/n.nn hh:mm:ss 


| 3. Review the apply exception log (SVMFAPP $ERRLOG). If necessary, correct any problems before 
( | going on. 


| vmfview apply @ 
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Step 4. Build a New GCS Macro Library 


1. Establish the correct minidisk access order: 


setup 
vmfsetup 56643082 gcs (bid @ 


| Program Update Service Only | 


2. If you are processing program update service, erase GCSNEW MACLIB if it exists. Do not erase 
GCSNEW MACTLIB if you are processing corrective service or local service. 


erase gcsnew maclib fm @ 
Ready; T=n.nn/n.nn hh:mm:ss 


PO End of Program Update Service Only ee 


Do the rest of this step if: 


e You are processing program update service and have local modifications to 
GCS macros or control blocks 
' @¢ You are processing corrective service 
¢ You are processing local service. 


3. Access 495 as A: 
access 495 a 


4. Find out which macros and control blocks have been updated by IBM. Look for replacement macros 
and copy files on the service disk: 


listfile * macro fm (EXEC @ The updates are on the alternate LOCALI 
Ready; T=n.nn/n.nn hh:mm:ss (495) disk if you are applying corrective service 
rename cms EXEC a gcsmcfix = = Mf or on the alternate DELTA (896) disk if you 
Ready; T=n.nn/n.nn hh:mm:ss are applying program update service. You 
listfile * copy fm (EXEC @ may also have updates on other disks in the 
Ready; T=n.nn/n.nn hh:mm:ss LOCALI string. | 

rename cms EXEC a gcscyfix = = @ 


The EXEC option saves the list in a file called 
CMS EXEC. Any previously existing CMS 
EXEC on your A-disk is erased. 


Ready; T=n.nn/n.nn hh:mm:ss 


5. Copy the macros and control files that have been serviced to your A-disk: 


copy fn macro fm = = a (replace @ 
copy fn copy fm = = a (replace 


6. Create or edit an EXEC to generate a macro library for updated macros called GCSNEW EXEC. It ~ 
should have the same format as CSISP EXEC, and should list: 


¢ For program update service, only those macros and control blocks for which you have received 
service and for which you also have local modifications 
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10. 


e For corrective service, all macros and control blocks for which you have received service, plus any 
for which you have local modifications 


¢ For local service, all macros and control blocks for which you have local modifications. 


If you have no macros or control block files that must be listed in GCSNEW EXEC, go to substep 12 on 
page 554. 


a. If you have not already created GCSNEW EXEC, issue: 

copy csisp EXEC fm gcsnew = a (recfm f Irecl 80 @ 

b. If you already have a copy of GCSNEW EXEC, issue: 

copy gcsnew EXEC fm = = a (recfm f lrecl 80 @ 
Now edit GCSNEW EXEC, adding the necessary macro and control block file names. If you created 
CMSNEW EXEC by copying CSISP EXEC, use the contents of CSISP EXEC only for a guide to the 
format of the macro entries. After you have added the macro and control block names you need to 
service, in the proper format, delete the macro names that came from CSISP EXEC. 


xedit gcsnew EXEC a 


file — 


. You now need to copy every macro and control block file listed in GCSNEW EXEC to your A-disk. 


copy fn macro fm = = a (olddate replace @ 
copy fn copy fm = = a (olddate replace @ 


. Generate the new macro library by using the VMFMAC EXEC: 


vmfmac gcsnew csixa Mf 
DMSUPD178I Updating macroname MACRO Al 
DMSUPD178I Applying macroname update Al 
macroname MACRO ADDED 


Ready; T=n.nn/n.nn hh:mm:ss 


Note: An alternate method to using the VMFMAC EXEC is to update the control blocks and macros 
by using the UPDATE module and issuing MACLIB DELETE and then MACLIB ADD 
commands for the MACLIB containing the changed macro or control block. 


See VM/XA SP CMS Command Reference for details on the MACLIB command. 


. The new macro library is now on your A-disk (295). You can now erase GCSNEW COPY (a file created 


by VMFMAC) from the 295 disk. 
erase gcsnew copy a @ 


Add the new macro library name to the TEXT MACS card in the CSIXA CNTRL file. Make it the first 
macro library listed so that you use the updated macros. 
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xedit csixa cntr!] @ 
locate/TEXT MACS @ 

TEXT MACS CSISP ... 
change/MACS/MACS GCSNEW/ @ 
TEXT MACS GCSNEW CSISP ... 
file @ 7 


11. If you want to make the new macro library available to general users, copy it to the GCS alternate 
BUILDI1 disk (895): . 


copy gcsnew maclib a = = 12 (replace @ 
12. Reaccess 495 as B and 191 as A: 


access 495 b Hf 
access 191 a Hf 
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Do this step if: 


You are processing program update service and have local modifications to 
the GCS message repository 

You are processing corrective service and have local modifications to the 
GCS message repository 

You are processing local service. 


1. Determine your system default national language: 
query lang @ 
ee langid See Table 5 on page 317 to identify the 
( language corresponding to langid. Note the 
ae country code for that language. 


2. Invoke the VMFNLS EXEC to update the GCS message repository: 


vmfnis csimesy repos 56643082 gcs @ y is the country code for your system national 
Ready; T=n.nn/n.nn hh:mm:ss language. 


3. If you have updates to the message repositories for any other national languages installed on your 
( “a, system, repeat substep 2 for each language. 
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Step 6. Assemble and Build the GCS Nucleus 


1. Establish the appropriate minidisk access order: 


setup @ 
vmfsetup 56643082 gcs (all @ 


2. If you did not create the TESTNSS EXEC in “Step 9. Create Test EXECs and Files” on page 478 of 
Chapter 13, “Rebuilding CMS after Applying Service,” do so now. 


3. Define a new named saved system with an alternate name: 


testnss altsysname @ altsysname is an alternate name for your GCS 
system, for example, ALTGCS. 


HCPNSD440I The Named Saved System (NSS) altsysname 


was successfully defined —_— 
in fileid fileno el 
QWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE ORIGINID | 
*NSS nonn NSS A_ nnnn mm/dd hh:mm:ss CMS NSS MAINT 
*NSS nonn NSS) A_ nnnn mm/dd hh:mm:ss CMSXA NSS MAINT 
*NSS so nnnn NSS S_snnnn mm/dd hh:mm:ss altsysname NSS MAINT 


4. Create a configuration file for the GCS system you are servicing. 


copyfile gcs group b altsysname = = (replace @ | ( * 
xedit altsysname GROUP @ oy 
locate /SYSNAME= @ 
change /SYSNAME=sysname/SYSNAME=altsysname/ @ 
locate /SEGMENTNAME= @ 
change /SEGMENTNAME=sysname/SEGMENTNAME=altsysname/ @ 
file 
5. Create an ASSEMBLE file for the GCS system you are servicing. 
copyfile altsysname group b = assemble = (replace @ . 7 


6. Use the VMFHASM EXEC to update and assemble the ASSEMBLE file. 


vmfhasm altsysname 56643082 gcs Mf 


DMSUPD181E No update files were found These are informational messages. You can 
ASSEMBLING altsysname ignore them. 
*** qgltsysname TEXT CREATED! *** 
PRT FILE fileno SENT FROM MAINT PRT AS fileno 
RECS nnnn COPY 001 A NOHOLD NOKEEP 
Ready; T=n.nn/n.nn hh:mm:ss 


7. Copy the TEXT file from your A-disk to the alternate LOCAL1 disk: 


copy altsysname text a = = b (replace @ 
Ready; T=n.nn/n.nn hh:mm:ss 
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8. Issue the following commands: 


change rdr class n class m @ 
Ready; T=n.nn/n.nn hh:mm:ss 

spool pun * class n nocont noeof @ 
Ready; T=n.nn/n.nn hh:mm:ss 

spool rdr class n keep @ 

Ready; T=n.nn/n.nn hh:mm:ss 

close pun &@ 

Ready; T=n.nn/n.nn hh:mm:ss 


9. XEDIT the GCSLOAD EXEC so that it will pick up the text deck you created in substep 6 on page 556 


for the system you are now servicing: 
xedit gcsload EXEC @ 
locate /&3 GCS @ 


change /&3 GCS/&3 altsysname/ @ 
file @ 


If you have already edited GCSLOAD EXEC 
to service another GCS system, you must 
locate and change the altsysname for that 
system instead of GCS. 


10. XEDIT the product parameter file to add altsysname to the :OVERLST. tag and to add an override 


section for altsysname: 


xedit 56643082 $ppf @ 

locate /:0VERLST. 

change /CORGCS/CORGCS altsysname/ @ 
bottom @ 

input 


saltsysname. GCS 
or 


saltsysname. CORGCS 
:BLD. REPLACE 
GCSLOAD VMFBDNUC BUILD1 


:END. 
z 
file @ 


11. Invoke VMFBLD to build the GCS nucleus. 


vmfbid 56643082 altsysname (punch 


This is a sample. 


Use GCS for PUT service, and CORGCS for 
COR service. 


(To ensure that text decks are copied to the 
correct disk during VMFBLD execution using 
VMFBDCPY, CORGCS is now the 
component name for GCS corrective service. 
This causes the corrective service override to 
be applied to the 56643082 $PPF and the 
DELTA disk string to be redefined). 


Press ENTER to return to the command line. 
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0000001 FILE CHANGED 
DMSBLD1851I Processing altsysname with 

the part handler VMFBDNUC EXEC 
LOAD LIST: $$$TLL$$ EXEC Al (MNT191) 


RDR FILE filenol SENT FROM MAINT PUN AS fileno2Z 
RECS nnnn COPY 001 N NOHOLD NOKEEP 


| | 12. Review the build exception log (6VMFBLD $ERRLOG). If necessary, correct any problems before 
- | going on. 


| vmfview build @ 


13. Issue the following commands: 


spool pun off eof @ 

Ready; T=n.nn/n.nn hh:mm:ss a 
close rdr @ — 
Ready; T=n.nn/n.nn hh:mm:ss = 
spool rdr class n keep @ 

Ready; T=n.nn/n.nn hh:mm:ss 


14. IPL your reader to save the new GCS system in the named saved system you created: 


ip] 00c clear @ 
MSG FROM MAINT: CSIIN1341I altsysname has nnnnnn 
bytes of available common free storage . P : 
HCPNSD440I The Named Saved System (NSS) altsysname ae 
was successfully defined in fileid fileno 


PRT FILE filenol SENT FROM MAINT RDR AS fileno2 This printer file is the GCS load map. Note 
RECS nnnn COPY 001 N NOHOLD NOKEEP the second file number. 
System reset 


15. IPL CMS (or ALTCMS): 


fi 
Ne 


ipl {cms|altcms} @ 

VM/XA CMS 5.5 mm/dd/yy hh:mm 
i 

Ready; T=n.nn/n.nn hh:mm:ss 


16. Save and print the GCS load map: 
#cp transfer prt fileno2 to * rdr @ 
access 595 e & 
receive fileno2 gcsnuc mape @ 


Once you have the load map saved on disk, you can print a copy of it by issuing the following command: 


print gcsnuc mape 


17. Repeat substeps 3 on page 556 through 16 for each GCS system you are servicing. 
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Step 7. Test and Rebuild CMS 


1. Perform Steps 10, 13, 1S, 16, and 17 of Chapter 13, “Rebuilding CMS after Applying Service” on 
page 457 to make the files that VMFBLD EXEC loaded to the 490 disk in Step 6 available to users. 
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ups 


Step 8. Test and Rebuild the GCS Nucleus 


Test the GCS nucleus you just built. When you are satisfied, repeat Step 6 to rebuild the nucleus with its 
original name. | 
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Step 9. Back Up the GCS Named Saved Systems 


1. Use the procedure in Step 29 of Chapter 2, “Installing VM/XA System Product Release 2 with the 
Starter System (First Level)” to back up the GCS named saved systems. 


Ed This is the end of the service procedure for GCS. Re 
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Chapter 17. Program Update Service to Licensed Programs 


This chapter describes: 


¢ Applying program update service to licensed programs that have a product service EXEC rather than 
a product parameter file. 


To apply service to licensed programs, refer to the publications for the specific licensed program. If the 
licensed program has a product parameter file, the general concepts described in this book for program 
update service are applicable. To apply corrective service, see the publications for the specific licensed 
program. 


If the licensed program has a product service EXEC, the following general procedure is applicable. 


1. Establish the minidisk access order: 
setup # 


2. Mount and ready the program update tape. 
3. Get the PUT documentation and map the tape: | 


vmfrec info (memos @ VMFREC INFO (MEMOS maps the tape 
and loads the tape map, the PUT document or 
COR document, and the Memo to Users to 
your A-disk. Read these documents before 
going on. 


4. Receive and apply service: 


vmfrec prodid parameters @ | VMFREC invokes the product service EXEC 
to receive and apply service. You can pass 
parameters to the product service EXEC. 


5. VMFREC may tell you that the level of service EXECs on the tape is different than the level of service 
EXECs on your system. Refer to the “Usage Notes” section of the VMFREC EXEC description (on 
page 710) for information on receiving a new level of the service EXECs. 


e If you have not made any local modifications to the old product parameter file, you can use the new 
file as it stands. Go on to the next step. 


e If you had any local modifications in the old product parameter file, your override file should be on 
the CMS LOCAL] disk string. Look at the new product parameter file on the 191 disk to see 
whether any changes from the last IBM-supplied product parameter file affect your override file. If 
you are applying corrective service, be sure to include the changes from the corrective service 
override section of the base file in your override file. 


The product parameter file has three sections for each component: 


a. Control options 
b. Minidisk assignments 
c. EXECs needed to update each part of the product. 


Chapter 17. Program Update Service to Licensed Programs 563 


You may change the first two sections to suit your installation, but it is not recommended that you 


change the EXEC section. 


Always place changes in an override file. Do not change the base product parameter file. 


Warning: The disk addresses in the SPLOAD PROFILE, user directory, 56643082 $PPF, and 


SETUP EXEC, and the default addresses used by the ITASK EXEC must all match. If you change © 


an address in any one of these places, you must change it in all the others. We recommend that you 


do not change any addresses. 


After you have made any necessary changes in your own override file, copy it to the 191 disk with 


the REPLACE option. 


For more information about the product parameter file, see “The Product Parameter File” on page 401. 


6. Check the Program Directory for the licensed product (not the VM/XA SP Program Directory) or other | 
licensed program documentation to see whether the product service EXEC, which VMFREC invoked for 


you in step 4 on page 563, builds the licensed program. For most products, it does. If it does not, 


invoke VMFBLD to build the licensed program: 


vmfbid prodid parameters @ 


VMFBLD invokes the product service EXEC 
with the BUILD parameter. The product 
service EXEC then rebuilds any part of the — 
licensed program changed by service that 
requires a build function. You can pass 
parameters to the product service EXEC. 


For compatibility, the VMSERV EXEC continues to be available to service this type of licensed program. 
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Chapter 18. Receiving and Applying Local Service 


This chapter describes: 


¢ Step-by-step procedures for applying local service to all components of VM/XA System Product using 
update files. 


Introduction 


Local service is defined as any service that is applied to your VM/XA SP system that was not supplied by 
IBM on a corrective service (COR) tape or program update (PUT) tape. 


Warning: The application of local service can be a complicated and error-prone procedure because of the 
many variables that are involved. IBM strongly advises its customers to order service on a COR tape 
through the IBM Support Center whenever possible. When it is absolutely necessary to apply service from 
IBM before it is available on a COR tape, or a local modification is required to tailor a system environment, 
you must apply the service locally. This should be done very carefully. 


Note: Before attempting to apply local service, please read Chapter 6, “VM/XA System Product Service—An 
Overview,” Chapter 7, “How VM/XA System Product Uses Control Files and Update Files,” 
and Chapter 8, “Files Used in Program Update Service and Corrective Service” of this book. It is 
very important to have a good understanding of how the service process works before you proceed 
with this chapter. 


Local service can be placed in two categories: 


¢ IBM local service includes any service that you receive from IBM that is not on either a COR or a PUT 
tape. Two common types of IBM local service are: 


— Emergency service from the change team 


When a severe problem arises and you cannot wait for a COR tape, you can get emergency service 
from the change team. This service can be sent to you on a tape or read to you over the phone. In 
either case, the service is not in the format required by the VMFREC and VMFAPPLY EXECs. To 
receive and apply this service, you must do it manually using the instructions in this chapter. 


— Service Received from INFO Access 


Any fixes obtained through INFO Access can also be obtained on a COR tape. If you choose to 
order a COR tape, it can be received and applied just like any other COR tape, with the automated 
service tools VMFREC and VMFAPPLY. If you choose not to order a COR tape, you must receive 
and apply it manually using the instructions in this chapter. 


¢ Customer local service includes any service that is not supplied by IBM. Customer local service is used to 
tailor your VM/XA SP system. An example of customer local service is given in Step 16 of Chapter 2, 
“Installing VM/XA System Product Release 2 with the Starter System (First Level).” The example given 
shows how to tailor the HCPBOX ASSEMBLE file. To receive and apply this service, you must do it 
manually using the instructions in this chapter. | 


The instructions in this chapter apply to all components of the VM/XA SP system (CMS, CP, DV, and 
GCS). Whenever there are variations for different components, they are noted. 


Chapter 18. Receiving and Applying Local Service 565 


Step 1. Preparation (For CMS Local Service Only) 


In order to be consistent with the philosophy of not building on top of your production system, you must 
perform the following steps before applying local service to CMS: 


1. Copy the latest version of the DMSNGP ASSEMBLE file to the 395 disk. (If there is already a copy of 
DMSNGP ASSEMBLE or DMSNGP TEXT on the 395 disk, rename it first.) Edit the copy and make 
the following changes: 


a. Change SYSDISK = 190 to SYSDISK = 490. 
b. Change IPLADDR = 190 to IPLADDR = 490. 
. Change HELP= 19D to HELP =49D (or HELP=19C to HELP=49C). 


. Change SYSNAME=CMS to SYSNAME = newname, where newname is the name you choose for 
your test system. The sample procedure in Chapter 13, “Rebuilding CMS after Applying Service,” 
uses ALTCMS. 


e. Change INSTSEG = CMSINST to INSTSEG = newname, where newname is the name you choose for 
your test installation segment. The sample procedure in Chapter 13, “Rebuilding CMS after 
Applying Service,” uses ALTINST. 


Q 


OQ. 


f. Change the VERSION = and INSTID= parameters to identify your test system. 


g. Make sure that SAVESYS=NO. If SAVESYS= YES, when you IPL CMS the system will try to 
save the alternate CMS segment that you define in Step 10 of Chapter 13, “Rebuilding CMS after 
Applying Service” in the existing CMS segment. 


These changes cause the new CMS nucleus (with service) to be built on the 490 minidisk. 
2. Use the DASD DUMP Restore program to copy the current BUILD disk to its corresponding alternate 
disk. 


ddr @ 
VM/XA SYSTEM PRODUCT DASD DUMP RESTORE PROGRAM 
ENTER CARD READER ADDRESS OR CONTROL STATEMENTS. 


ENTER: 

sysprint cons @ This command tells DDR to send program 

ENTER: messages to your console. 

input 190 devtype MNT190 @ 190 is your current CMS system disk. devtype 

ENTER: is the device type of the DASD volume where 
190 is located. 

output 490 devtype MNT490 @ 490 is your new CMS system disk. devtype is 

ENTER: the device type of the DASD volume where 


490 is located. 
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Me 


copy 900 endcyl @ 


DMKDDR711R Volid Read is MNT190. Do you 
wish to continue? 

yes @ 

ENTER NEXT EXTENT OR NULL LINE: 

= 


END OF COPY 
ENTER: 

i 

END OF JOB 


. Relabel the 490 minidisk: 


access 490 t 

Ready; T=n.nn/n.nn hh:mm:ss 
format 490 t (label @ 
ENTER LABEL: 

mnt490 

Ready; T=n.nn/n.nn hh:mm:ss 


The value for endcyl depends on the device 
type of your 190 disk: 


Device Type endcyl 


3350 73 
3375 112 
3380 71 


You have not yet changed the label of the 490 
minidisk. (You will do so in substep 3.) 


Access 490 after the system disk. You must 
use the label option. If you don’t, you will 
erase all the files on the 490 minidisk. 


. Repeat substeps 2 on page 566 and 3 to copy the current HELP disks (19D, 19C, 19B...) to their 


corresponding alternate disks (49D, etc.) and to relabel the alternate disks as MNT49n. Check the 
minidisk definitions in your user directory to find the appropriate value for endcyl. 
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Step 2. Receive Service 


I. Log on to MAINT and establish the appropriate minidisk access order: 


setup 

Ready; T=n.nn/n.nn hh:mm:ss 
vmfsetup 56643082 compid (all Mf 
Ready; T=n.nn/n.nn hh:mm:ss 


Substitute for compid the component you are 
servicing (CMS, CP, DV, or GCS). 


2. Merge the LOCAL1 minidisk string by copying the entire contents of the alternate LOCALI1 muinidisk to 
the intermediate alternate LOCALI1 minidisk and erasing the alternate LOCALI minidisk. 


Note: For the addresses of the LOCALI1 minidisks for the component you are servicing, see Figure 6 on 


page 364. 


copyfile * * b = = e (olddate replace @ 
Ready; T=n.nn/n.nn hh:mm:ss 

erase fn ft b @ 

Ready; T=n.nn/n.nn hh:mm:ss 


Substitute for fn and ft the file name and file 
type of each file you have on the alternate 
LOCALI. You may also use the ACCESS 
command with the ERASE option. If you 
choose to use ACCESS, after you issue the 
ACCESS command you must write a file to 
the disk in order to rewrite the file directory. 


3. Access the alternate LOCAL] as A in R/W mode and the intermediate alternate LOCAL] as B/A (an 
extension of A) in read-only mode: 


access vaddrl a @ 

DMSACC7241 vaddr1 replaces A (191) 
Ready; T=n.nn/n.nn hh:mm:ss 
release e 

Ready; T=n.nn/n.nn hh:mm:ss 
access vaddr2 b/a @ 

DMSACP7231 B (vaddr2) R/0 

Ready; T=n.nn/n.nn hh:mm:ss 


Substitute for vaddr/1 the virtual address of the 
alternate LOCAL (295, 395, or 495) and for 
vaddr2 the virtual address of the intermediate 
alternate LOCALI (591, 691, or 791). 


4. Place the service that you receive in one or more CMS files on the alternate LOCAL1 minidisk. 


| Service Supplied on Magnetic Tape | 


a. If service is supplied on a magnetic tape, you must mount the tape, attach the tape to MAINT’s 
virtual machine, and load the tape file onto the alternate LOCALI minidisk. 
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attach rdevno * 181 @ 
TAPE rdevno ATTACHED TO MAINT Q181 
Ready; T=n.nn/n.nn hh:mm:ss 


vmfplc2 load (eot disk @ 
LOADING... 

END-OF-FILE OR END-OF-TAPE 
Ready; T=n.nn/n.nn hh:mm:ss 
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rdevno is the real device number of the tape 
drive. 


The exact wording of this response may vary, 
depending on who is actually mounting the 
tape for you. 


The tape file is in VMFPLC2 format. The file 
created by this command is called TAPE MAP 
A, and lists the file names and file types of all 


files loaded to the alternate LOCAL! minidisk. 


rename tape map a icl = = @ Print or rename TAPE MAP A. You need to 
Ready; T=n.nn/n.nn hh:mm:ss refer to these files throughout the rest of the 


service procedure. Renaming the file prevents 
VMFPLC2 from overwriting it. 


a End of Service Supplied on Magnetic Tape Steg a 
| Service Supplied as Hard Copy or by Telephone | 


b. If service is supplied as hard copy or by telephone as the result of an emergency, your IBM Service 
Representative should supply you with the file name and file type of each required file. Make a list 
of these names. You must now type in these files. Use the XEDIT command to create each CMS 
file on the alternate LOCAL1 minidisk. 


ce ne ee End of Service Supplied as Hard Copy or by Telephone eee 
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Step 3. Apply Service 


Changes to the system are provided as new parts, replacement parts, or updates to existing parts initially 
shipped on the product tape. The following table shows the base file types that might be serviced and 
whether they are serviced by update or replacement service: 


EXEC With corresponding $EXEC 
Without corresponding SEXEC | Replacement ——~~S~™ 


For the following examples, assume that you have received emergency service from the change team. You 
have received one PTF, but it is not COR closed. A PTF is considered COR closed when it is made available 
for distribution on a COR tape. The PTF (UM34567) hits two modules, HCPABC and HCPXYZ. Also 
assume that you are creating customer local service for HCPQRS. These examples are for CP files, but the 
procedures for all components are the same. 


Note: Since GCS and DV are object-maintained, you do not have to worry about update service for these 
components. 


For the list of files that you are servicing, refer to the tape map (LCL MAP A) from the last step if you 
received service from tape, or to the list that your IBM Service Representative gave you if you received 
service as hard copy or over the phone. 


1. Determine the base file types of HCPABC, HCPXYZ and HCPQRS. 


For each unique file name that you are servicing, issue the LISTFILE command. Using Table 14 and 
“VM/XA SP File Types and Abbreviations” on page 861 as a guide, write down what the base file type 
is for each file name being serviced. 


listfile hcpabc * * @ In this example, you can see both an 

HCPABC _H98765HP__Al ASSEMBLE file and a corresponding TEXT 
HCPABC = =AUXLCL Fim file. This indicates that HCPABC is serviced 
HCPABC LOQOOI1LC fim by updates (source-maintained). 


HCPABC LCLOQQO1 fm 
HCPABC AUXXA fim 
HCPABC H12345HP fim 
HCPABC =TX132123 fim 
HCPABC ASSEMBLE __ fim 
HCPABC ~—CrTEXT fim 
Ready; T=n.nn/n.nn hh:mm:ss 
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listfile hcpxyz * * @ In this example, there is no corresponding 


HCPXYZ _TX134567 Al ASSEMBLE file, so the base file type is 
HCPXYZ AUXXA fin TEXT. This indicates that HCPXYZ is 
HCPXYZ H12345PP fm serviced by replacement (object-maintained). 
HCPXYZ TXT32123 fm Do not be confused by the update file 
HCPXYZ TEXT m HCPXYC H12345PP. It is only an update 
Ready; T=n.nn/n.nn hh:mm:ss shell. Update shells are explained below. 
listfile hcpqrs * * @ In this example, there is an EXEC and a 
HCPQRS EXEC fim corresponding $EXEC. This indicates that 
HCPQRS EXEC m HCPQRS is source update serviced. 


Ready; T=n.nn/n.nn hh:mm:ss 


2. Use XEDIT to create an AUX file entry on the AUXLCL level. 


There are three fields that make up an AUX entry. The first field contains the file type of the update 
ne file. Imbedded in this file type is the 5-digit numeric portion of the APAR number. When you originate 
( | an update, this 5-digit number should be a local tracking number. The second field is the level of the fix. 
For local service, use LCL in this field. If you want to keep your IBM local service separate from your 
customer local service, you can use LCx in this field (x is any alphanumeric character). The third field is 
the PTF number or a local tracking number. 


a. If an AUXLCL file already exists, as in the case of HCPABC, copy it to the alternate LOCAL], 
which is currently accessed as A. 


copyfile hcpabc auxicl fm ==a Substitute for fm the file mode of the minidisk 
eee Ready; T=n.nn/n.nn hh:mm:ss on which the AUXLCL file currently resides. 
| ( The existing HCPABC AUXLCL file has only one entry: 


LOOQOILC LCL LCQG@O01 * CUSTOMER LOCAL SERVICE TO CIRCUMVENT A PROBLEM 
This is a locally originated fix. 00001 is your local tracking number. 


If the new fix from IBM fixes the problem you circumvented with the entry in the AUXLCL file, 
replace the entry in the AUXLCL file with the new one from IBM. Your new AUX entry in the 
AUXLCL file 1s then: 


H98765HP LCL UM34567 * IBM UPDATE TO FIX THE PROBLEM 


( If the new fix from IBM is unrelated to the entry that is in the AUXLCL file, you must review your 
previous customer local service and rework it if necessary. Put the AUX entry for the new fix below 
the existing AUXLCL entry in the file. Then use XEDIT with the CTL option to rework the old 
AUX entry. The new AUXLCL file would look like this: 


LOOQOILC LCL LCOOQQ1 * REWORKED CUSTOMER LOCAL SERVICE — 
H98765HP LCL UM34567 * IBM UPDATE TO FIX A DIFFERENT PROBLEM 


b. If an AUXLCL file does not exist but another AUX file does, as in the case of HCPX YZ, you can 
copy and rename an existing AUX file to the alternate LOCAL1 which is currently accessed as ‘A’, 
and use it as a guide. 


copyfile hcpxyz auxxa fm = auxicl a @ Substitute for fm the file mode of the minidisk 
Ready; T=n.nn/n.nn hh:mm:ss that the AUXXA file currently resides on. 
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For HCPXYZ, you have a replacement text deck. Use XEDIT to look at the self-documenting 
information at the top of the new text deck: 


xedit hcpxyz txt34567 a The system displays a file like the one in 
: Figure 34. : 


H12345PP 201 UM32123 * THIS IS AN OLD FIX 

- HCPXYZ H12345PP fm nnnnnn mm/dd/yy hh:mm:ss 
* PREREQ: NONE 

* CO-REQ: NONE 

* TF-REQ: NONE 


H98765PP xxx UM34567 * THIS IS THE NEW FIX 

. HCPXYZ H98765PP fm nnonnnn mm/dd/yy hh:mm:ss 
* PREREQ: VM12345 

* CO-REQ: NONE 

* TF-REQ: NONE 


Figure 34. A Sample Replacement Text Deck (HCPXYZ TXT34567 A) Ne és 


In AUX files, the most recent entry is on top. In text decks, the most recent entry is on the bottom 
of the prolog. The first entry in the text deck is already in the HCPXYZ AUXXA file. The second 
entry is the new fix and requires that an AUX entry be made on the AUXLCL level. The AUX 
entry can be copied directly from the replacement text deck. The only change should be in the 
second field. As mentioned above, this field should be LCL, so the AUX entry in HCPXYZ 
AUXLCL should be: 


H98765PP LCL UM34567 * THIS IS THE NEW FIX —_— 


c. If no AUX files exist, as in the case of HCPQRS, use XEDIT to create one on the alternate Nu” 
LOCALI, which is currently accessed as A. | 


For HCPQRS, there are no existing updates, so when you have finished editing the AUXLCL file, 
the only entry in it should be the update that you are creating: | 


LOQOOZ2LC LCL LCOQO02 * LOCAL FIX TO CIRCUMVENT A PROBLEM 


Note: This process would be the same for other parts, including files with the file types ASSEMBLE, 
$EXEC, $XEDIT, MACRO, and COPY. 


3. Create an update file or update shell. 


Note: When VMFAPPLY creates an AUX entry for an update, the file mode of the update file is 
changed to 5. For local service, it is important that you do not change the file mode of the 
update files to 5. If VMFAPPLY tries to apply this same fix as part of a future corrective service 
application you get VMFAPPLY warning messages in the VMFAPPLY exception log. The result 
is that AUXCOR entries are not created for each text deck that has updates with file mode 5. If 
you want to use the VMFAPPLY convention of changing the update file mode to 5 so as to keep 
track of updates for which you have created AUX entries, you must keep manually applied local 
service and corrective service on separate disk strings (disk strings are defined in 56643082 $PPF). 
If you do this, subsequent corrective service is not affected. IBM recommends that its customers 
not do this. 


a. For HCPABC, IBM shipped you the update file for the fix. 


b. For HCPXYZ, IBM shipped you only a replacement text deck named HCPXYZ TXT34567. For 
this part, you must create an update shell. An update shell takes the place of the source update file 
that would exist if the part were on update service. Just as with the AUXLCL file for HCPXYZ, 
you can take the information for the update shell from the replacement text deck (see Figure 34). 
Your update shell for HCPXYZ should look like Figure 35 on page 573. 
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* PREREQ: VM12345 
* CO-REQ: NONE 


* DEPEND: NONE 


/ 

./ 

./ * IF-REQ: NONE 

/ 

/ * THIS IS AN UPDATE SHELL 


Figure 35. A Sample Update Shell (HCPXYZ H98765PP A) 


c. For HCPQRS, you must create your own update file because it is originated locally. Normally, you 
would already know what kind of change you wanted to make to HCPQRS. To create the update 
file, you will invoke XEDIT with the CTL option. 


xedit hcpqrs $exec a (ctl hcpxa If you receive message DMSXUP1/78I, 
: previous updates are being applied before your 
file new update is created. You should receive 
Ready; T=n.nn/n.nn hh:mm:ss message DMSXUP180W. This message tells 
pee, you that your new update cannot be found. 
( This is because you are in the process of 


creating it. At this point you can make your 
updates. Remember that these updates do not 
go into the $EXEC file, but instead are put in 
the HCPQRS L00002LC update file. 


Note: This process is the same for other parts, including files with the file types ASSEMBLE, $EXEC, 
$XEDIT, MACRO, and COPY. The CNTRL file varies from component to component. See 
Chapter 7, “How VM/XA System Product Uses Control Files and Update Files” on page 377 for 
( a description of the CNTRL files and to find out which one is appropriate for the service you are 
| performing. 


4. Create executable parts. 
At this point, you should have a correct AUXLCL file and a corresponding update file or shell. 


a. For HCPABC, you still need a text deck. This text deck is generated when you assemble HCPABC 
during the rebuilding process after you have finished this chapter. 


b. For HCPXYZ, IBM supplied you with a replacement text deck. The text deck, however, is not 
named consistently with the AUXLCL entry that you created. You must now rename this text deck. 


( ‘ rename hcpxyz txt34567 a = 1¢c134567 = 
Ready; T=n.nn/n.nn hh:mm:ss 


c. For HCPQRS, you still need an EXEC. This EXEC is generated when you run EXECUPDT for 
HCPQRS during the rebuilding process, after you have finished this chapter. 


The following lists the base file types that may be included in your local service, along with a brief 
description of how the executable part is generated. 


¢ ASSEMBLE with a corresponding TEXT or TXTnnnnn: Update 
You reassemble this part during the rebuilding process. 
¢ TEXT or TXTnannn with no corresponding ASSEMBLE: Replacement 
You must rename the new TXTznnnnn file to LCLuunnn, where nnnnn is the PTF number. 


rename file name txtnnnnn a = IclInnnnn = @ 
Ready; T=n.nn/n.nn hh:mm:ss 


Chapter 18. Receiving and Applying Local Service 573 


sitet sna et si NPIS SGI” Feateateienintpracanioeuntnin wpranauunms sa nfainnbimneiiainnmaam etme blll pes Epun EMEA es Melos ae fon he 


e EXEC with a corresponding $EXEC: Update | 
You will use EXECUPDT to generate the EXEC during the re-building process. 
¢ EXEC with no corresponding $EXEC: Replacement 


If you did not receive a new file with the file type EXEC with your service, and you did receive a file 
with the file type of EXCnnnnn, where nnunn is the PTF number, this file must be copied with the file 
type of EXEC: 


copyfile file name excnnnnn a = exec = (olddate @ 
Ready; T=n.nn/n.nn hh:mm:ss 


e XEDIT with a corresponding $XEDIT: Update 
You will use EXECUPDT to generate the XEDIT macro during the rebuilding process. 
e¢ XEDIT with no corresponding $XEDIT: Replacement 


If you did not receive a new file with the file type XEDIT with your service, and you did receive a 
file with the file type of XEDnnnnn, where mnnnn is the PTF number, this file must be copied with 
the file type of XEDIT: 


copyfile file name xednnnnn a = xedit = (olddate @ 
Ready; T=n.nn/n.nn hh:mm:ss 


¢e MACRO: Update 


You will use VMFMAC to generate a MACLIB with the new MACRO during the rebuilding 
process. 


¢ COPY: Update 


You will use VMFMAC to generate a MACLIB with the new COPY file during the rebuilding 
process. 


e Any other types: Replacement 


If the new replacement parts do not already have their appropriate file type, then they have an 
abbreviated form of the file type concatenated with the PTF number. Use “VM/XA SP File Types 
and Abbreviations” on page 861 to find out the complete file type and copy the file with the 
complete file type: 


copyfile file name xxxnnnnn a = ffffffff = (olddate @ 


ae Ee xxx is the abbreviated file type, nnnnn is the 


PTF number, and ffffffff is the complete file 
type. 


Note: After you rebuild the component to which you are applying local service, you may wish to do a 
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manual merge of the LOCAL! disk string. (For instructions, see Appendix G, “Controlling Disk 
String Merges” on page 859.) Because you have not run VMFREC to receive local service, no restart 
indicator files have been produced. If the next service you receive is from a corrective service tape, 
VMFREC does not perform the usual merge, so if you want it to be done you must do it yourself. If 
the next service you receive is from a program update tape, VMFREC merges normally. 
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MAP 0015: What to Do Next 


Do you have a service tape? 
Yes No 


— Go to the instructions for rebuilding the component to which you applied local service: 


CMS Chapter 13, “Rebuilding CMS after Applying Service” on page 457 

CP Chapter 14, “Rebuilding CP after Applying Service” on page 515 

DV Chapter 15, “Program Update Service or Corrective Service to the Dump Viewing Facility,” 
“Step 4. Build the Dump Viewing Facility” on page 542 

GCS Chapter 16, “Program Update Service or Corrective Service to GCS,” “Step 4. Build a New 
GCS Macro Library” on page 552. 


= 003 


— Go to the instructions for receiving service for the component to which you applied local service: 


CMS Chapter 9, “Receiving Program Update Service or Corrective Service for CMS” on page 435 
CP Chapter 10, “Receiving Program Update Service or Corrective Service for CP” on page 443 
DV Chapter 15, “Program Update Service or Corrective Service to the Dump Viewing Facility,” “Step 
2. Receive Service” on page 539 
Poe GCS Chapter 16, “Program Update Service or Corrective Service to GCS,” “Step 2. Receive Service” 


( on page 549. 
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Chapter 19. Emergency Local Service Using the Patch Facility 


This chapter describes: 
¢ Step-by-step procedures for applying patches to the CMS and CP nuclei. 


Introduction 


Before attempting to use the patch facility, please read the following sections of this book: 


Chapter 6, “VM/XA System Product Service—An Overview” on page 355 

Chapter 7, “How VM/XA System Product Uses Control Files and Update Files” on page 377 
Chapter 8, “Files Used in Program Update Service and Corrective Service” on page 385 
“HCPLDR Command” on page 613 in Appendix B, “EXEC and Command Format Summaries” 
“The Patch Facility” on page 640 in Appendix B, “EXEC and Command Format Summaries.” 
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The patch facility is used to circumvent problems in text decks on replacement service (object-maintained) 
that are part of the CMS or CP nucleus. If the problem you have is in a file that is not in the nucleus, you 
cannot use the patch facility. 


Patches to object code (TEXT files) exploit the capability of the HCPLDR module when VER, REP, and 
C ICS statements are included in the replacement files. 


The instructions in this chapter apply to CMS and CP. Whenever there are variations for different 
components they are noted. 


Your IBM service representative will give you the specific hexadecimal codes that need to be changed. 
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Step 1. Receive the Patch 


In the example below assume that you have identified the object-maintained part that is causing a problem in 
your VM/XA SP system. You call your IBM service representative, who tells you that there is no existing fix 
for the problem. He tells you that, in order to circumvent the problem, you can change the object code in 
HCPAFF at displacement X'061C' from X'0780' to X'0700'. This example is representative of the type of 
fix you may get. It changes a branch to a no-op. Finally, your representative tells you that he has assigned 
APAR number VM23877 to this problem. If your representative does not give you an APAR number, use a 
local tracking number. 


1. Log on to MAINT and establish the appropriate minidisk accesses: 
setup Substitute for compid the component you are 
Ready; T=n.nn/n.nn hh:mm:ss servicing (CMS or CP). 


vnfsetup 56643082 compid (all @ 
Ready; T=n.nn/n.nn hh:mm:ss 


2. Create a patch update file on the alternate LOCAL1 minidisk: 


xedit hcpaff p23877 b @ Your patch update file may look like 
input Figure 36. 
file & Note that the spaces shown in the example are 


required spaces. For information on patch 
update file control statement syntax, see the 
section “The Patch Facility” on page 640. 


Note that the earde annear ac cammentc in the 
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patch update file. The $3VMFPATS EXEC 
translates the control cards into the format 
required by the HCPLDR module before it 
calls HCPLDR. 


* PREREQ: NONE 

* CO-REQ: NONE 

NAME HCPAFF 

* This is a patch. It 
* will be replaced by 
* — APAR VM23877. 

VER 61C 0780 

REP 61C 0700 a 


./ 
-/ 
./ 
-/ 
./ 
| 
./ 
-/ 


+e + F F F HF 


Figure 36. A Sample Patch Update File 
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Step 2. Apply the Patch 


( 1. Use XEDIT to create an AUX file entry on the AUXPAT level. 


There are three fields that make up an AUX entry. The first field contains the file type of the update 
file. Imbedded in this file type is the 5-digit numeric portion of the APAR number of the fix. When you 
originate an update, this 5-digit number should be a local tracking number. The second field is the level 
of the fix. For patch service you must use TX$ in this field. Since there is no PTF number for the patch, 
the third field is the APAR number or a local tracking number. 


xedit hcpaff auxpat b @ Your patch AUX file might look like 
input & Figure 36 on page 578. 
file @ 


P23877 TX$ VM23877 * A PATCH TO BE REPLACED BY APAR VM23877 


( Figure 37. A Sample Patch AUX File 


Note: You would not normally have any service on the AUXLCL level for the part for which you are 
creating a patch, because service on the AUXLCL level is accomplished with source update files. 
If you have the source to update, a patch is not necessary. If, however, you do have service at the 
AUXLCL level, you must rework it so that it does not conflict with the patch you are applying. 
You must also rework any service you have on the AUXPAT level so that it does not conflict 
with the patch you are applying. 


ae 2. Check the control file you are using to make sure that it includes an AUX file identification record for 
( fs the AUXPAT level of service. 


“Main Control Files” on page 380 shows the contents of the default CNTRL files. The default CNTRL 
files for the VM/XA System Product system include the AUXPAT level at the highest level of service. If 
you modify the CNTRL file structure, you must make sure that the AUX file that you create for this 
patch is in your modified structure. 


MAP 0016: What to Do Next 


( 001 
- | -— Go to the instructions for rebuilding the component to which you applied the patch: 


CMS Chapter 13, “Rebuilding CMS after Applying Service” on page 457 

CP Chapter 14, “Rebuilding CP after Applying Service” on page 515 

DV Chapter 15, “Program Update Service or Corrective Service to the Dump Viewing Facility,” “Step 
4. Build the Dump Viewing Facility” on page 542 


GCS Chapter 16, “Program Update Service or Corrective Service to GCS,” “Step 4. Build a New GCS 
Macro Library” on page 552. 
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Chapter 20. Removing Service from VM/XA SP 


This chapter describes: 


¢ How to remove program update service, corrective service, or local service from any component of 
VM/XA SP. 


If you have a problem with a PTF, or if a PTF arrives for which you have applied a local circumvention, you 
will need to remove service you have applied. 


When you install program update service, corrective service, or local service to VM/XA System Product, you 
build your new system on different minidisks from your old system. You should still have your old system 
available so you can return to it simply by accessing the old disks. In this way, of course, you remove an 
entire level of service. If you wish to delete only certain PTFs from VM/XA System Product, follow the 
procedure in this chapter. 


First you must understand that many parts of a component, possibly of different kinds, may be serviced by a 
single PTF. You can tell what kind of part an update affects by the part’s file type: 


ASSEMBLE ASSEMBLE file 


TEXT or TXTnannn Text deck (“TEXT file’) 


EXEC or EXCnnnnn EXEC 


COPY or CPYnnnnn Control block (“COPY file’) 


XMEDIT or XEDnnnnn XEDIT macro 
nnnnn is the number of the most recently applied PTF. 


The examples in this chapter are written to assist you in understanding what has to be done to remove service 
from VM/XA SP. They are not meant to cover all possible situations. 


1. Make a list of all the PTFs you want to remove, leaving space to write in the corresponding updates. If 
you know the number of the APAR you want to remove, but not the corresponding PTF number, see 
Appendix I, “How To Find the PTF Number From the APAR Number” on page 865. 


In this example, we suppose that you want to remove only one PTF, UM00001, from CP. 


2. With every PTF, you receive a parts list, which identifies all the parts affected by that PTF. Examine the 
parts list: 


vmfsetup 56643082 cp (all Mf 
Ready; T=n.nn/n.nn hh:mm:ss 
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xedit um00001 $ptfpart fm & _ The file name of the parts list is the PTF 
number; the file mode is $PTFPART. In this 
example, UM00001 is applied from a ae 
corrective service tape and is therefore on the eo 


CP alternate LOCALI disk. If it had been ad 
applied from a program update tape, it would 
be on the CP alternate DELTA disk. 
HCPABC H34567HP UM00001 $PTFPART lists one update for 
HCPXYZ H34567HP HCPABC and one update for HCPXYZ, along 
HCPABC TXTQ0GO1 with the HCPABC text deck for this PTF. 
3. Since a text deck is shipped for HCPABC, it must be an ASSEMBLE file. To find out what kind of part 
HCPXYZ is, check its file type: 
listfile hcpxyz * * @ HCPXYZ is a macro. (Replacement macro 
HCPXYZ AUXCOR fm libraries are not shipped on IBM corrective Pa 
HCPXYZ MACRO fm service tapes. Macros are pulled together into f : 
HCPXYZ MACOQ0004 fm a macro library when service is applied with ™ 
HCPXYZ MACOOQ01 fm the VMFMAC command.) 
4. Comment out or delete the update entries in the auxiliary control file at the service level affected by the 
PTF. (It is better to comment them out, so that you can see what you did.) If the update you are 
commenting out or deleting is not at the top of the auxiliary control file, then you must also comment 
out or delete any updates above the update you are removing. You must also add them to your list of 
updates to be removed if they are not already there. 
—— 
xedit hcpabc auxcor Since PTF UM00001 was applied as corrective ee 7 
service, it should be listed in the auxiliary 
control file for the corrective service level. If 
you are using the main control file supplied by 
IBM, the file type of that auxiliary control file 
is AUXCOR. 
*H88888HP COR UMO0003 The update for PTF UM00001 is listed on the —| 
*H56789HP COR UMO0002 third line from the top. a 
*H34567HP COR UMQ0001 ed 


To comment out an entry, put an asterisk in 
front of it. Remember to comment out the 
entries above the one you want to remove too. 


H12345HP COR UMOO000 


file Hf 


xedit hcpxyz auxcor 
*HOQ999HP COR UMO0004 
*H34567HP COR UMOOQ001 
file 
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5. When you edited HCPABC AUXCOR and HCPXYZ AUXCOR, you found three more updates that 


must be 


removed. Add these updates, along with the corresponding PTF number in the third word of 


the AUX entry, to your list of fixes to delete. Your list of updates that must be deleted now contains: 


HCPABC H34567HP PTF UMOQO001 
HCPXYZ H34567HP PTF UMOO001 
HCPABC H88888HP PTF UMO0003 
HCPABC H56789HP ~==PTF UMOO00Z 
HCPXYZ H99999HP PTF UMOO004 


In addition to removing the updates on this list, you must also review the parts lists for the 
corresponding PTFs (UM00003, UM00002, and UM00004) to find all the additional updates in those 
PTFs. You must remove the whole PTF, not just part of it. Save that task for later. For now, just note 
that you will have to look at these additional PTFs after you finish removing the one you set out to 


remove. 


. If the PTF you are removing does not affect any text decks, go to Step 7 on page 584. If it does, as in 


this example, determine whether the text deck for which you are removing service is in the load list for 
this component (CPLOAD EXEC, CMSLOAD EXEC, or GCSLOAD EXEC): 


xedit 


cpload EXEC @ 


locate /hcpabc Mi 


qquit 


e If the text deck for which you are removing service is in the load list, then, when you apply the next 
PUT tape, the correct text deck, including only the updates that you didn’t comment out in the 
HCPABC AUXCOR file, is automatically used. Continue with Step 7 on page 584. 


e Ifthe text deck for which you are removing service is not in the load list, you must determine which 


text 


deck (TXTunnnn, where nnnnn is the PTF number) replaces the current HCPABC TXTnmnnn 


(which contains all four fixes, three of which you want to remove). 


a. 


First list all text decks for the module hit by the updates you want to remove: 


filelist hcpabc txt* * Hf 


HCPABC 
HCPABC 
HCPABC 
HCPABC 


b. 


TXTOOQ00 fm 
TXTOQ0O01 fim 
TXTOO0O2 fm 
TXTO0003 fm 


Next, find the text deck which contains only the update(s) you want to keep, in this case 
HCPABC H12345HP. It should be the text deck corresponding to the first update you did not 
comment out of the auxiliary control file in Step 4 on page 582 (in this case, HCPABC 
TXT00000); but, to make sure, you can examine the text deck corresponding to the update at the 
top of the auxiliary control file (in this case, HCPABC TXT00003). 


xedit hcpabc txt00003 
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* PREREQ: NONE HCPABC TXT00003 contains the three 
* CO-REQ: NONE updates you want to delete and the one update 
* IF-REQ: NONE you want to keep. 
H12345HP COR UMOQQQ00 ~* Comments | 

* PREREQ: NONE 

* CO-REQ: NONE 

* IF-REQ: NONE 

H34567HP COR UMQO001 * Comments 

* PREREQ: NONE 

* CO-REQ: NONE 

* TF-REQ: NONE 

H56789HP COR UMO0002 * Comments 

* PREREQ: NONE 

* CO-REQ: NONE 

* IF-REQ: NONE 

* DEPEND: HO1OQ1OHP 

H88888HP COR UMO0003 * Comments 


~~ 
(Executable text is here.) ; 


Find the text deck line which contains the latest update you want to keep. This is the update 
immediately above the first one you want to remove. The third word of that line is the PTF 
number for this update: UM00000. Prefix TXT to the numeric part of this PTF number for the 
file type of the new text deck: TXT00000. 


c. Since the current text deck for HCPABC contains the fixes you want to delete, you must replace 
it with the text deck that contains only update H12345HP. Enter: 


copyfile hcpabc txt00000 fm hcpabc text = (replace @ Ye y 


Ready; T=n.nn/n.nn hh:mm:ss fm is the file mode of the alternate LOCALI 
disk. 


7. Next, check each update file that you deleted or commented out of the auxiliary control file for 
DEPEND entries. The DEPEND entries identify previous updates that are dependent on the update you 
are removing. Such updates must also be removed. 


In this example, suppose that only HCPABC H88888HP contains a DEPEND entry. 


xedit HCPABC H88888HP @ 7 HCPABC H88888HP contains one DEPEND Ne 7 
./* PREREQ: NONE entry, for HCPABC HOI1010HP. (The file 

./* CO-REQ: NONE name of the dependent update file 1s the same 

./* IF-REQ: NONE as the file name of the update file you are 

./* DEPEND: HQ1010HP looking at. The file type is listed in the 

qquit & DEPEND entry.) 


8. Add any updates you find in DEPEND entries to your list of updates that you must remove. You know 
the APAR number for these updates (in this example, 01010) from the five numeric characters in the file 
type; but you do not yet know the corresponding PTF number. (Appendix I, “How To Find the PTF 
Number From the APAR Number” on page 865 will show you how to find it.) For now, put aeeenen 
marks in your delete list beside the DEPEND updates and come back to this point later. 
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The list of updates to be deleted now looks like this: 


HCPABC H34567HP PTF UMOQ0001 
HCPXYZ H34567HP PTF UMO0001 
HCPABC H88888HP PTF UMO0003 
HCPABC H56789HP PTF UMO0002 
HCPXYZ H99999HP PTF UMO0004 
HCPABC HO1O1OHP PTF 272272? 


9. Rename the update(s) you want to remove with a file mode of 1. 


rename HCPABC H34567HP fm5 = = fml @ 
Ready; T=n.nn/n.nn hh:mm:ss 
rename HCPXYZ H34567HP fm5 = = fml 
Ready; T=n.nn/n.nn hh:mm:ss 
rename HCPABC H88888HP fm5 = = fml 
Ready; T=n.nn/n.nn hh:mm:ss 
rename HCPABC H56789HP fm5 = = fml 
( Ready; T=n.nn/n.nn hh:mm:ss 


rename HCPXYZ H99999HP fm5 = = fml 
Ready; T=n.nn/n.nn hh:zmn:ss 
rename HCPXYZ HO1O1OHP fm5 = = fml 
Ready; T=n.nn/n.nn hh:mm:ss 


10. Repeat Steps 2 on page 581 through 9 for each update in your delete list. When you have done this, 
check the parts lists for the PTFs you noted in Step 5 on page 583 and delete any updates included in 
those PTFs that you missed. Then determine the PTF numbers for the DEPEND entries you found in 

a Step 7 on page 584 (see Appendix I, “How To Find the PTF Number From the APAR Number” on 
( " page 865) and delete those PTFs. 


11. Finally, rework local service to modules for which you have deleted service. (Local service is service 
listed at any AUX levels above the AUXCOR level in the control file for this component. See 
Chapter 18, “Receiving and Applying Local Service” on page 565.) 
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MAP 0017: What to Do Next 


Do you have a service tape? 
Yes No 


002 


— Go to the instructions for rebuilding the component from which you removed service: 


CMS Chapter 13, “Rebuilding CMS after Applying Service” on page 457 

CP Chapter 14, “Rebuilding CP after Applying Service” on page 515 

DV Chapter 15, “Program Update Service or Corrective Service to the Dump Viewing Facility, 
“Step 4. Build the Dump Viewing Facility” on page 542 

GCS Chapter 16, “Program Update Service or Corrective Service to GCS,” “Step 4. Build a New 
GCS Macro Library” on page 552. a 


bo] 


ge ate 


003 


— Go to the instructions for receiving service for the component from which you removed service: 


CMS Chapter 9, “Receiving Program Update Service or Corrective Service for CMS” on page 435 

CP Chapter 10, “Receiving Program Update Service or Corrective Service for CP” on page 443 

DV Chapter 15, “Program Update Service or Corrective Service to the Dump Viewing Facility,” “Step 
2. Receive Service” on nage 539 | 


GCS Chapter 16, “Program Update Service or Corrective Service to GCS,” “Step 2. Receive Service” i - 
on page 549. ew 
‘< J 
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Part 3. Appendices 


This book contains the following appendices: 


Appendix A, “VM/XA System Product Regeneration Requirements” on page 589, which shows which 
modules you must regenerate when you apply a fix to CMS code 


Appendix B, “EXEC and Command Format Summaries” on page 599, which shows the format and use 
of EXECs and commands you may need for installing and servicing VM/XA System Product 


Appendix C, “VM/XA System Product Starter System Information” on page 747, which gives sample 
system definition files and other information about the VM/XA SP starter system 


Appendix D, “Listing CP Data Areas and Control Blocks” on page 849, which describes a procedure for 
listing VM/XA System Product data areas and control blocks 


Appendix E, “Example of Alternate GCS Nucleus Placement” on page 853, which shows how to save 
your GCS nucleus at a different location than the one in the sample files 


Appendix F, “Restricted Logon Passwords” on page 857, which contains the IBM-supplied list of 
restricted passwords 


Appendix G, “Controlling Disk String Merges” on page 859, which tells you how to prevent the 
automatic merging of a disk string and how to merge disk strings manually 


Appendix H, “Service Reference Tables” on page 861, which lists the standard 3-character abbreviations 
for the various file types used in VM/XA SP and the parts supplied for service 


Appendix I, “How To Find the PTF Number From the APAR Number” on page 865, which shows the 
procedure for determining the number of a program temporary fix from the associated APAR number 


Appendix J, “Messages” on page 867, which contains messages issued by the service EXECs. 
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Appendix A. VM/XA System Product Regeneration 
Requirements 


CMS Regeneration Requirements 


Whenever you apply a fix to CMS source code, you must regenerate the CMS nucleus or some CMS 
modules. The following table shows which you must regenerate in each case. (If a source name does not 
appear in the table, either the file is contained within the CMS nucleus, or it is loaded by another file, for 
example, DMSBTB loads DMSBTP.) 


If you must regenerate the CMS nucleus, see Chapter 13, “Rebuilding CMS after Applying Service” on 


page 457. 
| ; Table 15 (Page 1 of 6). CMS Regeneration Requirements 
| ( r Requires Regeneration of 
Change in Source ‘Module/Nucleus EXEC Procedure to Use 


DMSACC Nucleus VMFBLD 
| DMSACF Nucleus VMFBLD 


DMSACM Nucleus VMFBLD 
i DMSASD ASSEMBLE CMSGEND 
( a DMSASM ASSEMBLE CMSGEND 


DMSASN ASSGN CMSGEND 
DMSBAB CMSDOS DOSGEN 


DMSBCT DMSDFT CMSGEND 
DMSBLG DMSDFT ‘CMSGEND 
DMSBOF DMSCUT CMSGEND 

( 7 . DMSBOP CMSDOS DOSGEN 

; DMSBTB CMSBATCH CMSGEND 
DMSBUS DMSCUT CMSGEND 
DMSCCM DMSCUT CMSGEND 
DMSCDI DMSDFT CMSGEND 
DMSCCK CATCHECK CMSGEND 
DMSCIA DMSCUT CMSGEND 
DMSCLS CMSDOS DOSGEN | 
DMSCMP COMPARE CMSGEND 
DMSCPY Nucleus VMFBLD 
DMSCVH CMSDOS DOSGEN — 
DMSDAS CMSDOS DOSGEN 
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Table 15 (Page 2 of 6). CMS Regeneration Requirements 


Requires Regeneration of 


Change in Source -Module/Nucleus EXEC Procedure to Use 
DMSDFT DMSDFT CMSGEND 

DMSDLK DOSLKED CMSGEND 
DMSDMP CMSDOS | DOSGEN 

DMSDOS CMSDOS DOSGEN 

DMSDSK DISK CMSGEND 

DMSDSL DOSLIB | CMSGEND 


C~ 
DMSFOR FORMAT CMSGEND — 
| 
# 


DMSHLB HELPCONV CMSGEND 
DMSHLD HELPCONV CMSGEND 
DMSHLI HELPCONV CMSGEND 
DMSHLP HELPCONV CMSGEND 
DMSHLS HELPCONV CMSGEND 
DMSICP IOCP CMSGEND 
DMSIDE Nucleus VMFBLD 

DMSICT DMSCUT _ CMSGEND 
DMSIMA | IMAGEMOD CMSGEND 
DMSLAB- CMSDOS DOSGEN 

DMSLBD LABELDEF CMSGEND 
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Table 15 (Page 3 of 6). CMS Regeneration Requirements 


Requires Regeneration of 
Change in Source Module/Nucleus EXEC Procedure to Use 


DMSMCM > CMSDOS DOSGEN 


( a DMSMDP MODMAP CMSGEND 
DMSMES[y ] DMSMEST[y ] (see Note 3 on VMFNLS 
page 594) 


DMSMGC GENMSG CMSGEND 
DMSMGD GENMSG CMSGEND 


DMSMGE GENMSG CMSGEND 
a, DMSMVE MOVEFILE CMSGEND 
( DMSOPL CMSDOS DOSGEN 
DMSORI CMSDOS DOSGEN 
DMSOR2 CMSDOS DOSGEN 
DMSOR3 CMSDOS DOSGEN 
DMSNXD NUCXDROP CMSGEND | 
DMSOPT OPTION CMSGEND 
( : DMSOSR OSRUN CMSGEND 
: DMSOVR SVCTRACE CMSGEND 
DMSOVS DMSOVS CMSGEND 
DMSPIO Nucleus VMFBLD 
DMSPBS DMSCUT CMSGEND 
DMSPCB DMSPCC CMSGEND 
DMSPCR DMSPCC CMSGEND 
DMSPCT DMSPCC CMSGEND 
DMSPOA PROPLIB (see Note 4 on CMSGEND | 
page 594) 
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Table 15 (Page 4 of 6). CMS Regeneration Requirements 


Requires Regeneration of 


Change in Source 7 Module/Nucleus = _ EXEC Procedure to Use 
DMSPOC | | PROPLIB (see Note 40n CMSGEND 
i, a | | page 594) 
DMSPOD | | PROPLIB (see Note 4 on = CMSGEND © 
7 | page 594) 
DMSPOE PROPLIB (see Note 4 on CMSGEND 
page 594) 
DMSPOL 7 PROPLIB (see Note a on CMSGEND 
- a page 594) 
DMSPON PROPLIB (see Note 4 on CMSGEND 
page 594) | 
DMSPOP | PROPLIB (see Note 4 on CMSGEND | a 
| page 594) oe 
DMSPOQ PROPLIB (see Note 4 on CMSGEND 
page 594) | 
| DMSPOR PROPLIB (see Note 4 on CMSGEND 
| page 594) 
DMSPOS #7 PROPLIB (see Note 4 on CMSGEND 
page 594) 
DMSPRE PRELOAD CMSGEND -_ 
eee 
DMSPRT Nucleus VMFBLD = 
DMSPRV PSERV CMSGEND 
DMSPUN | PUNCH CMSGEND 
DMSRDC READCARD | CMSGEND 
DMSRDR RDR CMSGEND | 
DMSRNE RENUM CMSGEND eke 
DMSRPG | | CMSDOS DOSGEN ae 
DMSRRV | RSERV | CMSGEND 
DMSRSV RESERVE CMSGEND 
DMSSAP DMSCUT CMSGEND 
DMSSCR EDIT (see Note 1 on page 594)  CMSGEND 
DMSSFD SAVEFD CMSGEND 
DMSSMG | DMSDFT CMSGEND 
DMSSNC DMSSNC CMSGEND 
~DMSSPA[y] DMSSPAT[y] (see Note 3 on VMFNLS 
| page 594) 
DMSSPR SETPRT CMSGEND C 
DMSSRT SORT CMSGEND Vy 
DMSSSK SETKEY CMSGEND 
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_ Table 15 (Page 5 of 6). CMS Regeneration Requirements 


Requires Regeneration of 
Change in Source Module/Nucleus EXEC Procedure to Use 


DMSSTX CMSDOS DOSGEN 


DMSTPH TAPE (see Note 2 on page 594) CMSGEND 
DMSTPI TAPE (see Note 2 on page 594) CMSGEND 
DMSTPJ TAPE (see Note 2 on page 594) CMSGEND 
DMSTRC DMSCUT CMSGEND 
DMSTRTT[y] DMSTRTI[y] (see Note 3 on VMFNLS 
i page 594) 
( . DMSTYP TYPE CMSGEND 
DMSUPD UPDATE CMSGEND 
DMSUSR DMSDFT CMSGEND 
DMSUTL LOADLIB CMSGEND 
DMSVAN CMSAMS VSAMGEN 
DMSVAS CMSAMS VSAMGEN 
( DMSVAX CMSAMS VSAMGEN 
i DMSVIP CMSVSAM VSAMGEN 
DMSVIS CMSDOS DOSGEN 
DMSVLT CMSDOS DOSGEN 
DMSVVN CMSAMS VSAMGEN 
DMSVVS CMSAMS VSAMGEN 
DMSXMS DMSXMS (see Note 5 on CMSGEND 
page 594) 
DMSXRE DMSXRE (see Note 5 on CMSGEND 
page 594) 
DMSZIT EDIT (see Note 1 on page 594) CMSGEND 
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Table 15 (Page 6 of 6). CMS Regeneration Requirements 


_ Requires Regeneration of | 


Change in Source Module/Nucleus _ EXEC Procedure to Use 
IOPCxxxx IOCP CMSGEND | 
IOPPxxxx IOCP CMSGEND 
VMFCLEAR VMFCLEAR GENMOD 
VMFDATE VMFDATE CMSGEND 

VMFDOS VMFDOS CMSGEND 
VMFLOAD VMFLOAD CMSGEND 


Notes: 


1. When invoked for EDIT, the CMSGEND EXEC procedure creates the EDIT module and then | 
reinvokes itself to create the EDMAIN module. 


. When the CMSGEND EXEC is invoked for TAPE, it creates the TAPE module and then reinvokes 
itself to create the DMSLMX and DMSTPx modules. 


3. y is the country code for your system national language. See Table 5 on page 317. 


4. You get messages DMSSLKO0008W and DMSSOP036E when you regenerate PROPLIB. You can 
ignore them. 


. All EDIT source files, except DMSXMS and DMSXRE, are contained within the CMS nucleus. 
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CP Regeneration Requirements 


If you apply corrective service to certain CP source files, you must also regenerate the corresponding CMS 
modules and stand-alone utilities that can be [PLed. The following table shows the source name, module 
name, and procedures used for regenerating the CMS module. 


The UTILITY EXEC is described in Appendix B, “EXEC and Command Format Summaries” on page 599. 


Table 16. CP Regeneration Requirements 


Requires Regeneration of 


Change in Source Module/Nucleus EXEC Procedure(s) to Use 
HCPBSL 3CARD LOADER UTILITY 
HCPCCF HCPFAA-H, CPFMTXA UTILITY 
. HCPFAL-M, HCPFAR, 
( Z HCPFON 
| HCPCCU HCPCCU UTILITY 
HCPDDC, HCPDDR, IPL DDRXA UTILITY 
HCPDDT, HCPDNC, 
HCPDNT 
HCPDIR DIRECTXA UTILITY 
HCPEDx DUMPLOAD UTILITY 
( HCPIFC, HCPREA CPEREPXA UTILITY 
HCPIMG GENIMAGE UTILITY 
HCPLDR HCPLDR UTILITY 
HCPLDL, HCPMDLAT CPLOAD EXEC UTILITY 
ee aaa. VMFNLS 
7 HCPNMT IMAGELIB UTILITY 
( HCPOPTNS HCPXA, HCPLDRCM VMFMAC 
7 HCPOVE OVERRIDE UTILITY 
HCPRET RETRIEVE - UTILITY 
HCPSADMP HCPSADMP UTILITY 
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Dump Viewing Facility Regeneration Requirements 


If you apply corrective service to the dump viewing facility TEXT files, you must also regenerate the dump 
viewing facility. The following table shows the TEXT file name, and the procedure for regenerating the. 
dump viewing facility. 


Table 17. Dump Viewing Facility Regeneration Requirements 


| Change in TEXT file Requires Regeneration of Module EXEC Procedure(s) to Use 


HCSxxx ADDMAP, DUMPSCAN, UTILITY 
MAP, PRTDUMP, SCAN, 
TRACERED 
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GCS Regeneration Requirements 


If you have local modifications to the GCS message repository, you must regenerate it. The following table 
shows the file name and the procedure to be used for regenerating the dump viewing facility. 


Table 18. GCS Regeneration Requirements 


Note: y is the country code for your system national language. See Table 5 on page 317. 
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Appendix B. EXEC and Command Format Summaries 


This section is a general reference for commands and EXECs you may use during system generation or 
service application. The commands and EXECs that appear here are: 


, ee ee ee 


ASMGEND EXEC 
CMSGEND EXEC 
DCSSGEN command 
DIRECTXA command 
DISKMAP EXEC 
DOSGEN EXEC 
GROUP EXEC 
HCPLDR command 
INSTFPP EXEC 
ITASK EXEC 

The Patch Facility 
PRELOAD MODULE 
SAMGEN EXEC 
SAMPNSS EXEC 
SETUP EXEC 
SPLOAD EXEC 
UPDATE command 
UTILITY EXEC 
VMEFAPPLY EXEC 
VMFBLD EXEC 
VMFHASM EXEC 
VMFLKED EXEC 
VMFMAC EXEC 
VMFMERGE EXEC 
VMFNLS EXEC 
VMFOVER EXEC 
VMFPLC2 command 
VMFREC EXEC 
VMFREMOV EXEC 
VMFSETUP EXEC 
VMFVIEW EXEC 
VMFZAP EXEC 
VSEVSAM EXEC 
ZAP MODULE 
ZAPTEXT EXEC. 
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ASMGEND 


ASMGEND EXEC 


The ASMGEND EXEC procedure builds the system assembler and creates the associated auxiliary directory. 
ASMGEND loads the text decks for the assembler in the correct overlay structure and produces a load map... 


Format 


The format of the ASMGEND EXEC is: 


Usage Notes 


1. The assembler text decks normally reside on the system S-disk in file mode S1. This disk must be a 
accessed in some additional file mode before issuing this command in order to locate these files. For : 
example: 


access 190 a & 
access 193 b 


2. Use the ASMGEND EXEC if you have modified the assembler IFOXnun MODULE) source. If you 
have not modified this source, and wish to create the assemble module, possibly after modifying 
DMSNGBP or after creating a new CMS system disk, use the CMSGEND EXEC. 


Messages by od 
a ed 

ENTER TARGET DISK MODE FOR ASSEMBLE MODULES 

DEFAULTS TO S-DISK IF NONE ENTERED. 

Explanation: Enter the mode letter of the disk containing the assembler modules. The ASSEMBLE 

command accesses this disk during processing. If you enter a mode letter, ASMGEND uses that mode letter 

as the “targetmode” operand of the GENDIRT command when it creates the auxiliary directory. If you do 

not specify a mode letter, S is used. on 

ASSEMBLE XF GEND COMPLETE. | ae 


Explanation: The system assembler and its associated auxiliary directory have been generated successfully. 


ASSEMBLE XF GEND FAILED. 


Explanation: The system assembler text files were not loaded successfully. 
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CMSGEND 


CMSGEND EXEC 


Use the CMSGEND EXEC procedure to generate a new CMS module or LOADLIB from a text file and 
place the new CMS module or LOADLIB on the specified disk. 


Format 
The format of the CMSGEND command is: 


CMSGEND CTLCMS — i 
A 


CTALL 
NOCLEAR 
MAP 
NOINV 


where: 


fn 
is the file name of the CMS module or LOADLIB that is to be generated by the CMSGEND EXEC. 
Only one file name may be specified in the CMSGEND command line. 


The file names that may be specified in the CMSGEND command are any disk-resident CMS commands 
and service programs. 


CTLCMS 
displays each CMS command as it is executed in the CMSGEND EXEC procedure. This is equivalent to 
the EXEC statement &CONTROL CMS. 


CTALL 
displays every executable statement as it is executed in the CMSGEND EXEC procedure. This is 
equivalent to the EXEC statement &CONTROL ALL. 


NOCLEAR 
specifies that the CLEAR option is not to be issued when CMSGEND invokes the LOAD command. 


MAP 
specifies that the NOMAP option is not to be issued when CMSGEND invokes the GENMOD 
command. 


NOINV 
issues the NOINV option when CMSGEND invokes the LOAD command; this suppresses the displaying 
of invalid cards at the terminal. If the text deck was created with the VMFASM EXEC, it may contain 
update listing information; these records are displayed during the loading process unless you specify 
NOINV. 


MODE fm | 
indicates the access mode of the disk to receive the new module. File mode A is the default. 


Usage Notes 


1. The assembler text decks normally reside on the system S-disk in file mode S1. This disk must be 
accessed in some additional file mode before you issue this command in order to locate these files. For 
example: 


access 190 a M (CMS system disk) 
access 293 b MI (CMS DELTA disk) 
access 193 c MP (CMS BASE disk) 
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CMSGEND 


2. Use the CMSGEND EXEC if you have not modified the assembler (IFOXmn) source, and wish to create — 


the assemble module, possibly after modifying DMSASM, DMSASN, DMSASD, or creating a new CMS 
system disk. 


3. You can also use the CMSGEND EXEC to regenerate the ASSEMBLE command when you move the 


CMS system disk. When you specify ASSEMBLE, CMSGEND prompts you to enter a disk mode letter — 


so it can refresh the assembler’s auxiliary directory. (Use the ASMGEND EXEC procedure if you are 
updating the assembler.) 


4. When using CMSGEND EXEC to regenerate the PROP command, you are only generating the 
PROPLIB LOADLIB. (The CMSGEND options NOCLEAR, MAP, and NOINV have no effect when 
generating the PROP command.) 


5. The file type of the text deck must be TEXT. 


How CMSGEND Works 
CMSGEND keeps a list of the CMS disk-resident modules and LOADLIBs, the file names of the text files 
used to create them, and any special attributes required to generate them. For example, the PRINT 
command must be generated with the ORIGIN TRANS and the SYSTEM options. It is composed of the 
DMSPRT text file. To generate a new PRINT module, you issue: 
cmsgend print @ 
*** CURRENT STATUS: 
FILE * PRINT MODULE A2 ' DOES NOT EXIST 
FILE ' PRINT MODULE Al ' DOES NOT EXIST 
*** LOADING: 

INVALID CARD - * DMSSP MACLIB Al 5.5CMS mm/dd/yy hh:mm 

DMS PRT SO Q0E000 

PRINT Q0E000 


***RESULTS: 
' PRINT MODULE A2 ' CREATED FROM TEXT DECK ( S ) DMSPRT 


WITH OPTIONS TRAMX SYSTEM NOMAP 


Rs 


Messages 


The CMSGEND EXEC procedure displays the following status and error messages: 


*** CURRENT STATUS: “fn MODULE An” [EXISTS|DOES NOT EXIST]. 


Explanation: This message indicates whether a generated module already exists. 


*** LINK EDITING: fn TEXT. 


Explanation: This message indicates that CMSGEND is link editing fn TEXT to create a LOADLIB. The 
existing LOADLIB is erased and not renamed when generating a new one. 
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CMSGEND 


*** LOADING: 

Explanation: This message indicates that CMSGEND is loading the text decks. 

*** (UNDEF. NAMES NORMAL FOR EDMAIN) 

*** NOW WE HAVE A SECOND PASS FOR EDMAIN MODULE. 

Explanation: These messages indicate that the EDIT command requires two passes to resolve undefined 
names. 

*** NOW WE HAVE A SECOND PASS FOR DMSTPI MODULE. 


Explanation: This messages indicates that the TAPE command requires two passes to generate the necessary 
modules. The first pass generates the DMSLMX module as the TAPE module; the second pass generates the 
DMSTPE, DMSTPG, DMSTPH, DMSTPI, and DMSTPJ text files as the DMSTPI module. 


*** RESULTS: | 
[‘fn? MODOLD AI’ WAS ERASED] 
(‘fn MODULE A2’ RENAMED TO ‘fn MODOLD A1’] 


‘fn MODULE A2’ CREATED FROM TEXT DECK(S) ... 

WITH OPTIONS .... 

Explanation: These messages indicate which existing modules were erased and renamed, which text files were 
used to create the new module, and the attributes used to create the module. 

ENTER GENDIRT TARGET DISK MODE LETTER 

( NULL LINE DEFAULTS TO “S” DISK ). 


Explanation: This message is issued when you specify ASSEMBLE. You should enter the mode letter of the 
disk that contains the system assembler. This letter is used as the target disk mode address for the 
GENDIRT command. 


*** KRROR MESSAGE ISSUED IS NORMAL FOR LINK EDITING. 


Explanation: If the TEXT deck was created with VMFASM EXEC, it may contain update listing 
information; these records will cause the linkage editor to generate an error message. The error is normal. 


ERROR OCCURRED. CMSGEND STOPS. 


Explanation: This message indicates that an error occurred and that CMSGEND processing ends. 


INVALID ARGUMENT /n. 


Explanation: This message indicates an invalid file name was specified on the command line. 


TYPE ‘CMSGEND /n < options >’. 


‘Explanation: This message indicates that no file name was specified on the command line. 
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DCSSGEN Command 


To install CMSINST, use the DCSSGEN command procedure. This command lets you build, load, and save 
a CMSINST segment that contains the EXECs and Editor macros that you select for your installation. 


The installation segment (CMSINST is the default name) is designed to contain EXECs and System Product 
Editor (XEDIT) macros. When a frequently used EXEC or editor macro resides in a saved segment, multiple 
users can share the same executing copy. 


Before you issue the DCSSGEN command you must create a file that contains a load list of the EXECs and 
System Product Editor (XEDIT) macro instructions to be loaded into the segment. Information about the 
load list follows this description of the DCSSGEN command. 


Format 
The format of the DCSSGEN command is: aa 
' } 
DCSSGEN segname 
| filename filetype filemode bee 
where: 


filename filetype filemode 
is the file ID of your load list. 


[ segname | | | 7 a : 4 
[ CMSINST |] 3 ew 
segname 
CMSINST 
is the name that you want to assign to the saved segment (segname). The default segment name is 
CMSINST. 
Note: The values for this command are positional. 
DCSSGEN performs the following operations: | aa 
ot 


¢ Processes the loadlist file, sequentially loading each EXEC and Editor macro into storage 
e Saves the segment 


e Writes a load map to the A-disk as segnrame DCSSMAP A. 


The Load List for the DCSSGEN Command 


The loadlist must be a fixed-format file with a logical record length of 80. Each record in the file must contain 
the fileid of one EXEC or System Product Editor macro or a comment. DCSSGEN processes the records 
sequentially. 
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DCSSGEN 


The format of a DCSSGEN loadlist entry 1s: 


fn ft [fm [execname [exectype] ] ] : | 


where: 


fn 


is the file name of the EXEC or editor macro to be loaded. 


ft 
is the file type of the EXEC or editor macro to be loaded. 


fm 
is the file mode of the EXEC or editor macro to be loaded. If the file mode is specified as *, DCSSGEN 
loads the first file in the disk search order that satisfies the file name and file type qualifications. 


execname 
is the file name to be assigned to the loaded EXEC or editor macro. The default is “=”, which means 
that the present file name is to be used. 


exectype 
is the file type to be assigned to the loaded EXEC or editor macro. The default is “=”, which means 
that the present file type is to be used. 


The file name and file type of the EXEC or editor macro can each be from one to eight characters. The valid 
characters are A-Z, a-z, 0-9, $, #, @, +, - (hyphen), : (colon), and _ (underscore). The execname and 
exectype may also be from one to eight characters. However, they are not limited to the file name and file 
type character set. The only characters NOT valid within an execname and exectype are =, *, ) (right 
parenthesis), ( (left parenthesis), and X'FF'. 


To enter a comment in the loadlist, type an asterisk (*) in column one followed by the text of the comment. 


For example, your loadlist entries may look like this sample: 


* Rename RDRLIST EXEC to MAIL EXEC 
RDRLIST EXEC * MAIL = 

FILELIST EXEC $ 

SYSPROF EXEC S$ 

PARSE XEDIT S$ 

DISCARD EXEC §$ 

NOTE EXEC S$ 

PROFNOTE XEDIT §$ 

ALL XEDIT $ 


Before you process your loadlist, remove the comments and unnecessary blanks from the source program to 
conserve storage space. The EXECUPDT command with the NOCOMMENTS option removes all 
comments and leading blanks. One comment line containing the exec name and exec type is inserted at the 
beginning of the file. If the source file contains Double-Byte Character Set (DBCS) characters, also specify 
the ETMODE option. For more information about the EXECUPDT command, refer to VM/XA SP CMS 
Command Reference. 
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In the load map file, the records copied from your loadlist file are left-justified. The records created during 
the build process are indented five spaces. Comments are also copied from your loadlist file, with an asterisk _ 
(*) in column one followed by the text. | € BS 


The load map file (CMSINST DCSSMAP A) for the sample loadlist would look like this: 


* RENAME RDRLIST EXEC TO MAIL EXEC 

RDRLIST EXEC * MAIL = | 
15:41:59 10/22/85 copy of RDRLIST EXEC S loaded as MAIL EXEC 
EXISBLK - 280000 FBLOCK - 280100 LENGTH - 001C40 

FILELIST EXEC $ | 
15:41:58 10/22/85 copy of FILELIST EXEC S loaded as FILELIST EXEC 
EXISBLK - 280020  FBLOCK - 281D40 LENGTH - 0018C8 

SYSPROF EXEC S$ 
7:30:18 11/26/85 copy of SYSPROF EXEC S loaded as SYSPROF EXEC 
EXISBLK - 280040 FBLOCK - 283608 LENGTH - 002178 

PARSE XEDIT S 
8:47:55 12/18/84 copy of PARSE XEDIT S loaded as PARSE XEDIT 
EXISBLK - 280060  FBLOCK - 285780 LENGTH - 0024A0 —_ 

DISCARD EXEC S Re. ee 
15:40:32 10/22/85 copy of DISCARD EXEC S loaded as DISCARD EXEC 
EXISBLK - 280080 FBLOCK - 287C€20 LENGTH - 0012B0 

NOTE EXEC S$ 
11:03:53 10/24/85 copy of NOTE EXEC S loaded as NOTE EXEC 

_ + EXISBLK - 2800A0  FBLOCK - 288EDO LENGTH - 005310 

PROFNOTE XEDIT S 
15:41:55 10/22/85 copy of PROFNOTE XEDIT S loaded as PROFNOTE XEDIT 
EXISBLK - 2800CQ FBLOCK - 28E1E0 LENGTH - 000980 


ALL XEDIT S$ a 
15:41:05 10/22/85 copy of ALL XEDIT S loaded as ALL XEDIT _ . 
EXISBLK - 2800EQ FBLOCK - 28EB60 LENGTH - 001298 a 


*** End of Source List *** 
CMSINST built at 15:56:34 on 12/02/86 
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DIRECTXA Command 


DIRECTXA 1s a CMS command used to create a CP user directory. 


Note: This command works in a System/370 mode virtual machine only. 


Format 


DIRECTXA Po. ees Hl [(options ... DT] 


options: 


[EDIT] [MIXED] 


where: 


fn 
USER 


is the file name of the directory. If not specified, the file name is USER. 


ft 
DIRECT 


is the file type of the directory. If not specified, the file type is DIRECT. 


+ 


is the file mode of the directory. If not specified, the file type is * (the command searches all accessed 
disks for the file name and file type). 


EDIT 
allows you to issue the DIRECTXA command without updating the directory on disk. With this option, 
you can check the syntax of directory control statements. 
MIXED 
specifies that the DIRECTXA command is to ignore VM/SP statements and options encountered in the 


directory. This allows you to use a directory from a VM/SP system. DIRECTXA prints informational 
messages for each statement or option it ignores. 


How the Directory Program Works 


The DIRECTXA command performs the following steps during execution: 


1. The program looks for the file you specified on the DIRECTXA command line. If you did not specify a 
file name or a file type, the program looks for a file that has the file name of USER and a file type of 
DIRECT. 


2. If the program does not find the directory or an error occurs during processing, the program does not 
create a directory and the old directory remains on line. The program will continue to check the syntax 
of all control statements before ending. 
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3. DIRECTXA looks for the RPWLIST DATA file, which contains alist of restricted passwords. (The 
RPWLIST DATA file supplied by IBM is printed in Appendix F, “Restricted Logon Passwords” on 
page 857. You can edit it to add your own restricted passwords.) If the RPWLIST DATA file is not _ 


found, DIRECTXA issues a warning message but continues processing. If the RPWLIST DATA file is. | 


found, DIRECTXA checks all the passwords in the directory against it and changes any restricted 
passwords (except the password of the user issuing the DIRECTXA command) to NOLOG. Any user 
whose password is changed to NOLOG will not be able to log on. If the password of the virtual 
machine issuing the DIRECTXA command is restricted, it is not changed to NOLOG. DIRECTXA 
issues an error message and does not update the directory. 


4. If DIRECTXA runs out of DASD space, the program prints an error message and ends immediately. To 


continue, you must allocate more cylinders for the user directory. 


If DIRECTXA runs out of virtual storage, the command issues an error message and ends immediately. 
To continue, you must define more virtual storage (DEFINE STORAGE conned), oe the 
following formula, calculate the size of virtual storage you need. 


ystor = 50 Kb + (16 bytes x userids) 


where: 


vstor 
is the amount of virtual storage in the program area that DIRECTXA requires. 


userids 
is the total number of users defined in the directory. 


5. If no errors occur, the program writes the directory on DASD and writes the DASD address of the new 
directory on the volume label for that device. If the program is updating an active system directory, the 
program makes the new directory immediately available for the system. 


Usage Notes 


1. A complete description of the directory program, including a description of seston control statements, 
is contained in VM/XA SP Planning and Administration. 


2. When writing a user-directory, DIRECTXA does not overwrite the current directory, but does write an 
alternate user directory. The directory pointer in cylinder 0 is then changed to reference this new 
directory. It is advisable, therefore, to issue the DIRECTXA command twice. This assures that the 
directory you wish to use is available; otherwise, you may lose your directory again. 


Restrictions 
1. The DIRECTXA command executes only under CMS. 
2. You must have CP privilege class A, B, or C in order to update the system user directory. 


3. You cannot use the DIRECTXA command to create a directory in VM/XA SP Release 2 format on the 
VM/XA SP Release 1 system residence volume. You must create the Release 2 directory on a different 
physical pack. 


Examples 
To compile the USER DIRECT source directory and apply it to the system if successful, enter: 
directxa user direct * 


To do a test compile of a USER DIRECT source directory from a VM/SP HPO 5 system, ignoring control 
statements that are valid only for VM/SP or that contain options valid only for VM/SP, enter: 
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directxa user direct * (edit mixed @ 


Messages 


VM/XA SYSTEM PRODUCT USER DIRECTORY CREATION PROGRAM - RELEASE 2.0. 


Explanation: You have invoked the directory program. 


EOJ DIRECTORY UPDATED AND ON LINE. 
Explanation: The directory has been updated. The new directory has been placed in use by CP. 


EOJ DIRECTORY UPDATED. 


Explanation: The directory has been updated, but has not been placed in use by CP. You receive this 
response if you write the directory to a CP-formatted DASD that is not a CP-owned volume, or if you do 
not have the necessary privilege class to change the CP directory that is in use. 


EOJ DIRECTORY NOT UPDATED. 


Explanation: The directory has not been updated. You receive this response if you issue the DIRECTXA 
command with the EDIT option. You also receive this response if errors prevent the directory from being 
updated. 


Return Codes 


The DIRECTXA command issues the following return codes: 


_ Possible Causes 
DIRECTXA executed successfully. The real CP directory has been updated (unless the 
EDIT option was specified). 


Sr The directory source file was not found on an accessed disk. 


An error was encountered while processing the directory source file. 


fare An invalid option was specified on the DIRECTXA command line. 


l 
2 
3 
No errors were encountered, but you do not have the proper privilege class to update the 
real CP directory. 
5 
7 | 


Condition code 1 was received from the DIAGNOSE X'3C'. 
a A class A, B, or C user updated a virtual directory. 
Condition code 2 was received from the DIAGNOSE X'3C'. 


Condition code 3 was received from the DIAGNOSE X'3C'. 


A fatal I/O error occurred. 


9 The directory has been rewritten, but warning messages have been issued. 
> 100 Return codes greater that 100 may be returned and will be accompanied by message 764. 


See the explanation for message 764 for details on these return codes. 


DIRECTXA was run in EDIT mode, and at least one invalid password was changed to 
| NOLOG. 
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DISKMAP EXEC 


The DISK MAP EXEC summarizes the MDISK statements in the user directory. The output produced by 
this EXEC shows gaps and overlaps between minidisk assignments. 


Format 
The format of the DISKMAP EXEC is: 


DIRECT 


‘teenie einai Rereaermtemaie 


DISKMAP | filename Fret j 


where: 


filename 
is the file name of the directory to be mapped. 


filetype f™ 
is the file type of the directory to be mapped. The default is DIRECT. es oF 


The output from the DISKMAP EXEC is a file sent to your A-disk. The file name of the output is the same 
as that of the target directory. The file type of the output is DISKMAP. The file contains information on 
MDISK statements found in the directory. The files are in order by volume in the output file. Gaps between 
minidisks and overlapping minidisks are flagged. 


DISKMAP does NOT replace the EDIT function of the DIRECTXA command. You should use both to 


check your directory after changes, (For a descrintion of the DIRECTXA command, see “DIRECTXA 


Command” on page 607.) a \ 
Usage Notes 


1. Because some DASD types come in several sizes, DISK MAP does not list gaps found after all minidisks. 
You need to know the maximum cylinder/block value for your DASD type. 


2. DISK MAP creates both the map and a workfile on your A-disk. If your directory 1s very large and your 
A-disk is almost filled, you may need to find some extra disk space in order to run DISKMAP. 


3. You may choose to include some overlaps in the directory. DISKMAP flags all overlaps; you must a 
understand your layout to determine if a particular overlap is expected or in error. | 


Example 
To see how DISKMAP works, enter: 
diskmap user Hf 


This produces a map of the sample directory that you loaded during installation of VM/XA SP. 
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DOSGEN EXEC 


Use the DOSGEN EXEC to create the segment called CMSDOS, which contains text files needed to create a 
CMS/DOS environment that simulates DOS/VSE (Disk Operating System/Virtual Storage Extended) under 
CMS. 


To install CMSDOS, use the DOSGEN EXEC procedure in Step 27 of Chapter 2, “Installing VM/XA 
System Product Release 2 with the Starter System (First Level),” Step 27 of Chapter 3, “Installing VM/XA 
System Product Release 2 with the Starter System (Second Level),” or Step 29 of Chapter 4, “Installing 
VM/XA System Product Release 2 Using an Existing VM/SP or VM/SP HPO System.” You invoke 
DOSGEN with the hex load address and the name that you want to assign to this segment. This load 
address and name must match the address and name that you defined for this segment. 


Notes: 
1. The CMSDOS segment must be defined at a higher address than the CMSBAM segment. 


= 2. Before you load and save CMSDOS, you must define your virtual machine with at least 512KB free 
( . storage above the end of the CMSDOS segment. This provides room for the loader tables, which occupy 
the top pages of virtual storage. After you load and save the segment, the loader tables and the 512K B 
free storage are no longer required. 


DOSGEN performs the following operations: 


e Checks that the specified virtual address contains valid characters and that it is greater than X'20000' 
and less than 16MB 


¢ Looks for a read/write accessed A-disk on which to write the CMS loader work file 
eo e Loads all the text files needed for VSE simulation, starting at the address specified 
( | e Assigns a storage protection key of X'D' 
e Saves the segment 


e Writes the load map to the A-disk as LOAD MAP AS. 


Messages 


( ete DMSGENO095E INVALID ADDRESS. 
Explanation: DOSGEN detected an error in the address that you specified. 


DMSGENO006E NO READ/WRITE A-DISK ACCESSED. 
Explanation: DOSGEN could not find a read/write accessed A-disk. 


DMSGENI11E DOSGEN FAILED DUE TO LOAD ERRORS. 


Explanation; DOSGEN found unresolved external references while loading the text files. 


DMSGEN412S DOSGEN FAILED DUE TO SETKEY ERRORS. 
Explanation: DOSGEN detected an error while assigning the storage key. 


DMSGENI41S DOSGEN FAILED DUE TO SAVESYS ERRORS. 
Explanation: DOSGEN detected an error while saving the segment. 
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GROUP 


GROUP EXEC 


Use the GROUP EXEC to set up a group control system (GCS) configuration file. You can invoke the 
GROUP EXEC from the CMS environment. When you do, you see a series of panels on which you enter 
information about your virtual machine group. 


Format 


The format of the GROUP EXEC is: 


fsystemname | 


where: 


systemname ? Po 


iS an optional parameter that specifies the file name that you want to assign to the configuration file. If 
you enter this parameter with the GROUP command, then the Primary Option Menu panel appears with 
the SYSTEM NAME field filled in. If you enter the GROUP command without this parameter, then 
you must complete the SYSTEM NAME field on the Primary Option Menu panel. In either case, the 
system name that you specify must match the SYSNAME entry for this GCS system in the DMKSNT | 
file. The sample SYSNAME entry is GCS. | 


For an example of using the GROUP EXEC panels, see “Step 25. Load, Build, and Save GCS” on page 75. | 
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HCPLDR Command 


The HCPLDR command invokes and controls the system loader to perform one of two possible functions: 


¢ If you issue the HCPLDR command without the PUNCH option or the TAPE option, the loader 
generates a system (directly under CMS); this means the system loader link-edits all object files and 
passes control to the program (HCPGEN) that writes the system on the system residence device. 


¢ If you issue the HCPLDR command with either the TAPE option or the PUNCH option, the loader 
creates a continuous card deck beginning with a three-card loader, continuing with a stand-alone version 
of the system loader, and ending with the object files belonging to the system to be generated. When you 
issue HCPLDR with the TAPE or PUNCH option to generate CP, the loader will not link-edit object 
modules and will not pass control to HCPGEN to write the system on the system residence device. 


Issue the HCPLDR command under CMS. 


Note: This command works in a System/370 mode virtual machine only. 


Format 
HCPLDR ctlfile 
loadlist Pr IC... iaiia [(options ... [)]] 
options: 
TAPE 
[MAP] [PAGEB] ea [NOCTL] 
where: 
loadlist 


is the file name of the load list EXEC file; it contains the names of the object files in the order in which 
they are to be loaded. The load list may look like: 


&CONTROL OFF 
&1 &2 &3 HCPLDR LOADER 
&l &2 8&3 fn [ft] 
&l &2 &3 fn [ft] 


jn and ft are the file name and file type of an object file. The ft is optional. If ft is omitted, HCPLDR 
searches the control file or an explicit list of file types to determine the file type. 


HCPLDR LOADER must always be the first file. HCPLDR loads each object module in order from the 
top of the load list to the bottom. 


You can place most loader control statements in the load list EXEC file. You cannot place VERIFY, 
REPLACE, or INCLUDE CONTROL SECTION statements in the EXEC file. A loader control 
statement begins with a 12-2-9 punch (X'02'). Whenever HCPLDR encounters X'02' in the first 
column of a record, it interprets that record as a control statement. For more information see “Loader 
Control Statements” on page 615. 


ctlfile 
is the file name of the control file. For more information about control files, see “UPDATE Command” 
on page 657. 


HCPLDR uses the update level identifiers in the control file to determine the file type for those object 
modules listed in the load list without file types. The command skips the MACS record in the control 
file and searches for update level identifiers from the top of the control file down. If HCPLDR finds an 


Appendix B. EXEC and Command Format Summaries 613 


~HCPLDR 


update level identifier other than TEXT, the command appends the identifier to TXT to create a file 
type, then searches for the file (fn TXTxxxxx). If HCPLDR cannot find an object file that has the first 
update level identifier, the command finds the next identifier and continues the search. As a last resort, 
when HCPLDR cannot find the object file according to update level identifiers, the command searches 
for fn TEXT. For example, if the control file is: | 


TEXT MACS HCPM20 HCPM1D 
SPEC AUX1111 
TBM1 AUXR21 


HCPLDR follows this search order: 


fn TXTSPEC 
fn TXTIBM1 
fn TEXT (last resort) 


If an asterisk (*) or a period appears in the first column of a control file record, HCPLDR ignores the 
record. The command also ignores update level identifiers of PTF. 


fil Uf] -..ft256] 
is a list of file types (up to 256) that you want HCPLDR to use in lieu of a control file. HCPLDR ee 


establishes a search order from left to right. The list of file types can be null, in which case a file type 
must be specified for each object module in the load list EXEC. 


If you place a slash (/) anywhere in the file type list, HCPLDR notifies you when it loads an object 
module that has a file type to the left of the slash. 


You must use the NOCTL option if you specify file types directly on the HCPLDR command line. 
Assume you want to establish the following search order for HCPLDR: 


fn TXT1 
fin TXT2 | aa 
fin TXT3 Le 
Also, you want to be notified when HCPLDR uses file type TXT1 or TXT2. The load list you are using 
is CPLOAD EXEC. Enter the following command: 
hcpldr cpload txtl txt2 / txt3 (noct] ss 
When you enter a list of file types on the command line, HCPLDR does not look for fn TEXT 
automatically. 
MAP 
requests HCPLDR to produce a load map of the system it creates. The load map is called loadlist MAP a oS 
Al. Ne J 


This option is not valid if you use the TAPE or the PUNCH option. If you use the TAPE or PUNCH 
option, the system loader creates a load map when you load (IPL) the tape or reader. 


PAGEB 
requests that every CSECT be placed on a 4-kilobyte page boundary. 


This option is not valid if you use the TAPE or the PUNCH option. 


TAPE 
sends the output of object files to a tape drive at virtual device number 0182. At the command 
execution, HCPLDR does not link-edit the system; rather, HCPLDR places a three-card loader and a 
stand-alone loader before the object modules. When you load (IPL) the tape, the stand-alone loader 
link-edits the object modules and passes control to the program (HCPGEN) that writes the system onto 
the system residence device. The stand-alone loader also creates a load map of the system. HCPLDR 
ignores MAP or PAGEB, if you specify those options along with TAPE. 
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PUNCH 
sends a punch file to virtual punch 000D. At the command execution, HCPLDR does not link-edit the 
system; rather, the command places a three-card loader and a stand-alone loader before the object 
modules. You can spool your punch to your virtual reader or some other (System/370 or 
System/370-XA) virtual machine reader. When loaded (IPL), the stand-alone loader link-edits the object 
modules and passes control to the program (HCPGEN) that writes the system onto the system residence 
device. HCPLDR ignores MAP or PAGEB, if you specify those options along with PUNCH. 


NOCTL 
is the option you must use when you use a list of file types in lieu of a control file. HCPLDR will 
establish a search order of file types according to what you enter on the command line. 


Usage Notes 


1. When you use the system loader as a system generator, your virtual machine must have sufficient storage 
to contain CMS plus the entire system you are generating (in the case of CP, this includes any V=R 
region). If the system is too large to generate directly, use the stand-alone version of the system loader. 


é 2. Using the PAGEB option improves the debugging task since it eliminates needless arithmetic (the lower 
bens three hexadecimal digits of the load address is the same as the assemble address). Note, however, that 
PAGEB should only be used for testing purposes because the option wastes storage. 


3. After the new CP nucleus resides on the system residence device, you can shut down your present system 
(with the SHUTDOWN command) and perform a hardware load of the new system. 


4. The following response may appear when you load the CP nucleus: 


CSECT'S WITH SIZE GREATER THAN CONDITIONAL PAGE 
BOUNDARY @MAPSTRT xxxxxx HCPEMA xxxxxx 


( : This response is for information only and is no cause for concern unless other CSECTs are listed. The 
aa response indicates that the CSECTs are larger than the specified page size. HCPEMA contains the error 
message text and @MAPSTRT is the machine-readable load map. CP handles these CSECTs in a 
special way. If any other pageable modules exceed the page size, ensure that you have not added any 
CPB load control statements to the load file and then notify the IBM Support Center. 


Loader Control Statements 
. The following describe loader control statements, which can be actual cards or card images. The following 
( general rules apply to loader control statements: 
1. The first column of the loader control statement must be X'02' (the 12-2-9 punch). 
2. Columns 2 through 4 must contain the statement acronym. 
3. Unless stated otherwise, operands can appear anywhere between columns 5 and 72. 
4. Unless stated otherwise, operands must consist of arguments of no more than eight characters. 
5 


. If a control statement has more than one operand, the operands must be separated by blanks. 
Printer Control Statement 


The printer control statement enables or disables printing of the cross-reference listings and load maps. 
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Format: 
pos LE 
X'02' 

oe 
OFF 

where: 

X'02' 

must appear in column one. 
PRT 


is the printer control statement acronym. 


{ON | rdevno } 
enables printing of cross-reference listings and the load map. If you specify ON, the printer is at OO0E. Bais 
If you specify rdevno, the printer is at that device number. ( 


OFF 
disables printing. 


If you issue the HCPLDR command without the PUNCH or TAPE option, this operand is ignored. 


Note: Only one operand may appear on the statement. 
Set Page Boundary Control Statement 


The set page boundary control statement aligns the next CSECT according to the page size specified. — 


Format: 

where 

X'02' C 
must appear in column 1. | es 

SPB 


is the set page boundary control statement acronym. 


nnnnn 
is the page size in hexadecimal. The page size may be any power of 2 from 8 to 65536. If not specified, 
the page size is X'1000' (decimal 4096). 


Note: Only one argument may appear on the statement. 
Unconditional Page Boundary Control Statement 


The unconditional page boundary control statement aligns all subsequent CSECTs according to the page size 
specified. 
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Format: 


where: 


X'02' 
must appear in column I. 


UPB 
is the unconditional page boundary control statement acronym. 


nnnnn 
is the page size in hexadecimal. The page size may be any power of 2 from 8 to 65536. The initial value 
is 8. If not specified, the page size is X'1000' (decimal 4096). 


Note: Only one argument may appear on the statement. 
Conditional Page Boundary Control Statement 


The conditional page boundary control statement conditionally aligns all subsequent CSECTs according to 
the page size specified. If a CSECT will not fit within the remainder of the present page, the system loader 
will locate the CSECT on the next page boundary. 


Format: 


where: 
X'02' 
must appear in column 1. 


CPB 
is the conditional page boundary control statement acronym. 


nnnnn 
is the page size in hexadecimal. The page size may be any power of 2 from 8 to 65536. If not specified, 
the page size is X'1000' (decimal 4096). 


Note: Only one argument may appear on the statement. 


Usage Note: The standard value for page sizes is X'1000' (decimal 4096). Module HCPMM4 uses this 
standard size for the CP nucleus. 


Set Location Counter Control Statement 
The set location counter control statement sets the next CSECT at an absolute address. 
Format: 
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where: 


X'02' 
must appear in column 1. 


SLC | 
is the set location counter acronym. 


nnnnnnnn 
is the absolute address in hexadecimal. 


Note: Only one argument may appear on the statement. 


Usage Notes: 
1. Module HCPSYS uses the set location counter control statement to set the size of the V=R area. 


2. CMS uses the set location counter control statement to set the transient and user areas. 
Padding Control Statement 


The padding control statement fills all unspecified locations in a CSECT with a specified value. 


Format: 


X'02' 
must appear in column 1. 
PAD 
is the padding control statement acronym. 


nn 
is the fill character in hexadecimal. The initial value is 0. 


Note: Only one argument may appear on the statement. 


Usage Note: Padding helps in debugging a program; if a program references unspecified areas, you can 
detect such references by padding with a value of X'FO' or some similar value. 


Parameter Control Statement 
The parameter control statement supplies a parameter string that a loaded system uses upon execution. 
Format: 


where: 


X'02' 
must appear in column 1. 
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PRM 
is the parameter control statement acronym. 


parmstring 
is a parameter string having a 2-byte length field followed by the parameter. When the system begins 
execution, general purpose register one addresses this parameter string. 


Subsystem Control Statement 


The subsystem control statement specifies a subsystem and the location within a virtual machine where the 
subsystem appears. Such a subsystem is a separately loaded system, having its own relocation, page 
boundaries, cross reference listings, and load maps. However, the system loader loads the subsystem as a 
part of the main system. Use such a “system loaded within a system” for stand-alone programs. You can 
load the programs as part of the CP nucleus. 


Format: 


where: 
X'02' 
must appear in column 1. 


SYS 
is the subsystem control statement acronym. 


name 
is the name of the subsystem. 


loc 
is the location where the subsystem appears in the virtual machine. If omitted, the location is 0. 


Loader Termination Control Statement 


The loader termination control statement terminates the current system or subsystem. Control is passed to 
the entry point specified on the loader termination control statement. Every subsystem control statement 
must have its corresponding loader termination control statement and there must be one loader termination 
statement for the base system. 


Format: 


where: 


X'02' 
must appear in column I. 


LDT 
is the loader termination control statement acronym. 
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name | | 
is the entry point name that receives control after the system nucleus is loaded into real storage. This 
operand is ignored for subsystems. | 


Replace Control Statement 


The replace control statement replaces instructions and constants in virtual storage. 


Format: 


3 
[sada [ [outa [ne [| [mw 


X'02' | REP 


a 


where: 


X'02' 
must appear in column 1. -— 


REP 
is the replace control statement acronym. 


sadd 
is the hexadecimal starting address of the area that will be replaced. 


esdid 
is the External Symbol Identification, a number assigned by the compiler or assembler to the CSECT in 
which the replacement occurs. 


filds | co 
can be up to eleven 4-digit hexadecimal fields, separated by commas, each replacing one halfword. A a 
comma cannot follow the last field. 


nu 
means “not used” by the loader. The field may be left blank or contain program identification. 
Usage Notes: 
1. The replace control statement must be in hexadecimal code. 


2. The data in columns 17-70 (excluding commas) on the replace statement replaces what already was —_ 
loaded into virtual storage beginning at the address specified in columns 7-12. | ‘a 


3. A replace statement may appear: 


e Immediately preceding the END statement of an object module, if the module does not contain 
relocatable data (such as address constants). 


¢ Immediately preceding the first relocatable dictionary statement, if the object module does contain 
relocatable data. 


4. If additions made by the replace statements increase the length of a CSECT, an include control section 
control statement must appear preceding the object module. 


5. If the most recent VER control statement for a CSECT failed, the replace operation for that CSECT 
does not occur. 
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Verify Control Statement 


The verify control statement verifies a corresponding replace control statement, i.e., verify assures that the 
proper data is replaced. 


Format: 


peo [ver | [ww [faa [nae 


where: 


X'02' 
must appear in column 1. 


VER 
is the verify control statement acronym. 


sadd 
is the hexadecimal starting address of the area to be verified. 


esdid 
is the External Symbol Identification, a number assigned by the compiler or assembler to the CSECT in 
which the verification occurs. 


fids 
is up to eleven 4-digit hexadecimal fields, separated by commas, each verifying previously loaded 
halfwords. A comma cannot follow the last field. 


nu 
means “not used” by the loader. This field may be blank or contain program identification. 
Usage Notes: 
1. The verify control statement must be in hexadecimal code. 


2. The data in columns 17-70 (excluding commas) on the verify statement verifies what already was loaded 
into virtual storage beginning at the address specified in columns 7-12. 


3. Place verify control statements immediately before corresponding replace control statements. 
4. If the verify function fails: | 
¢ The loaded system does not execute. 
¢ All following REP control statements for that CSECT are ignored until the next successful VER 
control statement for that CSECT. 
Include Control Section Control Statement 


The include control section statement changes the length of a CSECT. Use it only when replace control 
statements cause a control section to increase in length. 
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Format: 


name size 


where: 


X'02' 
must appear in column 1. 


ICS 
is the include control section statement acronym. 


name | 
is the name of the CSECT you wish to enlarge. 


Size 
is the total size required for the CSECT. If size is smaller than the assembled size, the assembled size is 
used. 

Usage Notes: 


1. Both arguments in the include control section statement are required. 


2. The include control section statement must appear before the first ESD statement of the CSECT. 


Delete Control Statement 


DEL name] [... name8 | 


where: — 


X'02' | 
must appear in column 1. 


DEL 
is the delete control section statement acronym. 


name] |...name8 | 
is up to eight CSECT names. These names must not be previously defined within the load. Subsequent 
attempts to define these names as part of the system or subsystem will result in those CSECTs being 
deleted. 
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INSTFPP EXEC 


Use the INSTFPP EXEC to install licensed programs. 


Format 


The format of the INSTFPP EXEC is: 
INSTFPP [ prodspec!l [ prodspec2 _...prodspecn ]] [ (options Dy] 


options: 


Prompt ee 
NOPrompt NOMemo 


Install Rewind 
NOInstall NORewind 


( Ma ss) 


prodspecl ... prodspecn 
are the product specification codes that let you specify the products you want processed. These codes 
consist of the product number and the feature identification code as listed in the FEATURES 
PRODUCTS file. If no feature identification code exists for a product, specify just the product number. 
If one exists, attach it to the end of the product number. Specify these codes without imbedded hyphens 
( or other punctuation. INSTFPP scans the files on the stacked tape and processes the selected licensed 
programs. 


Prompt 
displays the prompts that ask if you want to process the specified licensed programs. PROMPT is the 


default. 


NOPrompt 
eliminates the prompts that asks if you want to install the specified licensed programs. 


Memo 
( prints a product Memo to Users from the tape for each selected product. MEMO is the default. 


NOMemo 
lets you process the selected products without printing product Memo to Users. You cannot specify 
NOMEMO if you have specified NOINSTALL. 


Install 
lets you install the selected products. Install is the default. 


NOInstall 
lets you process the selected products without installing them. You cannot specify NOINSTALL if you 
have specified NOMEMO. | | 


Rewind 
makes sure the tape is rewound before and after product installation and that it is properly mounted. 
REWIND is the default. 


NORewind : 
lets INSTFPP processing continue without tape rewinds before and after product installation. You can 
specify NOREWIND only if you invoke INSTFPP from the command line. 


Note: Make sure the tape is properly mounted and attached as 181. You can only install products 
located after the initial tape position. 
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lets you process all the products on the tape. ALL is the default if you do not enter product specification 
codes. 


rdev 
lets you specify the real tape address if the tape is mounted on a tape drive but not attached to MAINT 
as 181. 


Before Running INSTFPP 


Before you invoke INSTFPP to install licensed programs: 
1. Log on to the MAINT user ID. 
2. Make sure that MAINT has all privilege classes. Enter: 


access 291 c 
xedit user direct @ 


locate/USER MAINT | _ 


You should see a line that looks something like this: 
USER MAINT NOLOG 16M 32M ABCDEFG 
The last field in this line defines the privilege classes assigned to MAINT. If your installation uses the 


IBM-supplied privilege classes, you should have classes ABCDEFG. If you do not, type in any classes 
MAINT needs. 


3. While you are still looking at MAINT’s directory entry, check to see if the MAINT 319 minidisk is . mS 
defined. If it is not, you must define it. oy 


a. File your directory. 
file @ 


b. Map your USER DIRECT and examine the map to find a space for the 319 minidisk. Look fora 
gap of appropriate size and record the starting cylinder of that gap. The size you need depends on 
the number of program products you want to install. 


diskmap user direct @ f 
File USER DISKMAP A has been created. | 


c. XEDIT your directory and add an entry for the new minidisk: 


xedit user direct Hf 


locate/USER MAINT @ Locate the MAINT minidisk definitions. 
locate/MDISK @ | 


MDISK 319 devtype startcyl cyl label MW ALL M@ ~~ devtype and label are the device type and label 
of the DASD volume where the new minidisk 
is located. startcyl is the starting cylinder of 
the gap where the new minidisk is defined. cyl 
is the size of the new minidisk in cylinders. 
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a Press ENTER to return to the command line. 
file @ 


4. If you changed the directory, either to authorize new privilege classes for MAINT or to define the 
MAINT 319 minidisk, issue DIRECTXA to update the directory and bring it online: 


directxa user 

VM/XA SYSTEM PRODUCT USER DIRECTORY CREATION PROGRAM - RELEASE 2.0 
HCPDIR750W RESTRICTED PASSWORD FILE NOT FOUND 

EOJ DIRECTORY UPDATED AND ONLINE 

Ready; T=n.nn/n.nn hh:mm:ss 


. Link to the MAINT 319 minidisk in read/write mode: 


link * 319 319 w @ 


. Format the 319 minidisk if you have just defined it: 


format 319 p (blksize 2048 @ 

DMSFOR603R FORMAT will erase all the files on disk P(319). 
Do you wish to continue? 
Enter 1 (YES) or 0 (NO). 

1 

DMSFOR6O05R Enter disk label: 

mnt319 @ 

DMSFOR733I Formatting disk P 

DMSFOR732I ?? cylinders formatted on P(319) 

Ready; T=n.nn/n.nn hh:mm:ss 


. Access the 319 minidisk as P: 


access 319 p & 


. Make sure that you are linked to the following minidisks: 


MAINT 190 (System disk) 
MAINT 191 (MAINT’s work disk) 
MAINT 193 (CMS BASE) 
MAINT 194 (CP BASE) 


The INSTFPP EXEC expects these disks to be accessed with these numbers. If your corresponding disks 
have different numbers, redefine and reaccess them. For example, if your system disk is 490 instead of 


190, issue: 


define 490 190 @ 


access 190 fm @ | fm is any unused file mode. You cannot access 
the redefined system disk as S. 


9. Make sure that the INSTFPP code is on one of these disks. Enter: 


listfile instfpp exec * @ 
INSTFPP EXEC S2 
Ready; T=n.nn/n.nn hh:mm:ss 


10. Mount the optional feature product tape. INSTFPP stops if the tape is not mounted correctly. 
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1]. 


U2. 


13. 


INSTFPP 


Print a hard copy of your directory: 
print user direct 


Many product installation EXECs link to the user minidisks in write mode. If the link attempt fails, you 
may be asked to enter the write password of the minidisk. 


Verify that you have temporary disk space available on a DASD volume of the same type as your system 
residence volume. You need at least 30 contiguous cylinders of 3380 temporary disk space or an 
equivalent amount of 3350 or 3375 disk space. Enter: 


#cp query alloc 


DASD rdevno volid type TDISK TOTAL=nnnn INUSE=nnnn AVAIL=nnnn 
PAGE TOTAL=nnnn INUSE=nnnn AVAIL=nnnn 
SPOOL TOTAL=nnnn INUSE=nnnn AVAIL=nnnn 
DRCT TOTAL=nnnn INUSE=nnnn AVAIL=nnnn [ACTIVE] 


The system issues this response for each DASD 


volume attached to the system. ACTIVE 
indicates the DASD volume containing the 
active directory. 


If necessary, use the CPFMTXA command to allocate more temporary disk space. See VM/XA SP 
CMS Command Reference. 


Enter: 
instfpp (noinstall memo @ 


to print the product Memo to Users for reference and to copy the Memo to Users to the MAINT 319 
minidisk. | 

Make sure that appropriate spooling control options are in effect to direct the virtual printer spool files 
INSTFPP produces with the PRINT command to the desired real printer. Enter: 


#cp query tag printer @ 
PRT vdevno TAG: 
tagtext 


If you are not satisfied with this setting, change it. You may have to invoke the CP SPOOL command 
and/or the CP TAG command. 


If your printer handles only uppercase characters, use the FOLD option of the CP LOADBUF 
command. If your printer does not accept the LOADBUF command, print memos by issuing the 
PRINT command with the UPCASE option. In addition, if your printer cannot print special characters 
contained in the product memos printed by INSTFPP, look online at the product Memo to Users on the 
MAINT 319 minidisk. 


Refer to VM/XA SP CP Command Reference and VM/XA SP CMS Command Reference for more 
information about these commands. 
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15. Set your virtual storage size to 16MB unless the product Memo to Users specifies otherwise. 


define storage 16M @ 

STORAGE = 16M 

STORAGE CLEARED - SYSTEM RESET 
ip] cms @ 

VM/XA CMS 5.5 mm/dd/yy hh:mm 
| 

Ready; T=n.nn/n.nn hh:mm:ss 


16. Mount the product tape on a tape drive and ready the tape drive. 
Warning: Do not attach the tape drive to MAINT. The INSTFPP EXEC will attach it. 


Running INSTFPP 


You can run INSTFPP in panel mode or by specifying products directly. 


e If you want to install several licensed programs, or one licensed program for which you do not know the 
product specification code, you will find it easier to run INSTFPP in panel mode. Follow the 
instructions under “Using the INSTFPP Panels.” 


e If you want to install only a few licensed programs and know the product specification codes, or if you 
want to install all the licensed programs, you can run INSTFPP either way. If you prefer to specify 
products directly, go to “Specifying Products Directly” on page 631. 

Using the INSTFPP Panels 
1. Invoke INSTFPP with no arguments from a 3270 device (20 line minimum). 


2. When a panel appears on your screen, enter the real tape drive address, change defaults if necessary, and 
press ENTER. 


3. If you choose not to install all products on the product tape, type an X next to the products you want to 
install. 


Figures 38 through 44 on pages 628 through 631 show the INSTFPP panels. 


Appendix B. EXEC and Command Format Summaries 627 


INSTFPP 


SOINSO1 INSTFPP INSTALLATION OPTIONS 


If appropriate, change any defaults and then press the ENTER key. 


Real tape address (will be attached as 181): 
Process all products on the tape (Y/N)? Y 
Be prompted before each product is processed (Y/N)? Y 


Alternatives: 
(1) Install the product(s) and print the memo(s) 
(2) Only print the product memo(s) 
(3) Only install the product(s) 
Enter (1, 2, or 


ce > 
PF1=Help : 
PF7= 12=Cursor 
=> 
Figure 38. INSTFPP Panel 1 
Note: if the reai tape address appears as R/W, your tape drive is attached to MAINT. Quit and detach the a 
tape drive, then reissue INSTFPP. | | K J 
SOINSO2 INSTFPP PRODUCT SELECTION PANEL Line 1 of 68 
Type an X next to the product(s) you want to install 
When you have finished, press the PF5 key to begin | 
the installation process. 
5668854 ACF /Network Control Program oo 
5664289 ACF/System Support Program ( 
5664280 ACF/Virtual Telecommunications Access Method Me 


PF 
PF 


5668899 
5668808 
5767032 
5798RWL 
5664329 
5664296 
5668813 
5668814 
5668918 


1=Help 
7= 


=> 


APL2 

Application Prototype Environment 
Application System 

Composition Utility 

Contextual File Search/370 for VM/CMS 
Cooperative Viewing Facility Version 2 

Cross System Product/Application Development 
Cross System Product/Application Execution 
Cross System Product/Application Query 


4=Return 5=Execute 


8=Forward 9=Sort(prodid) 10=Sort(desc) 11= 


Figure 39. INSTFPP Panel 2 
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SOINSO2 INSTFPP PRODUCT SELECTION PANEL Line 13 of 68 


Type an X next to the product(s) you want to install 
press the PF5 key to begin 


When you have’ finished, 
the installation process. 


5748XE4 
5748XXB 
5664370 
5748XX9 
5735XXB 
5654260 
5668890 
5798DFH 
5668801 
5668812 
5668812 
5664200 


Directory Maintenance 

Display Management System for CMS 
DisplayWrite/370 

Document Composition Facility 

Emulation Program 

Environmental Recording Editing and Printing Program 
Font Library Service Facility 

FORTRAN Utilities 

Graphical Data Display Manager - IMD 

Graphical Data Display Manager - PGF 

Graphical Data Display Manager - PGF NL Feature 
Graphical Data Display Manager Base 


PF1=Help 
PF7=Backward 8=Forward 


4=Return 5=Execute 


9=Sort(prodid) 10=Sort(desc) 11= 12=Cursor 


===> 


Figure 40. INSTFPP Panel 3 


( | SOINSO2 INSTFPP PRODUCT SELECTION PANEL Line 25 of 68 
Type an X next to the product(s) you want to install 
When you have finished, press the PF5 key to begin 


the installation process. 


5664200 
5668905 
5799AXX 
5799BKE 
5668996 
5664185 
5798DTE 
5668897 
5668012 
5664282 
5664285 
5664204 


PF1=Help 
PF7=Backward 8=Forward 


===> 


NL 


Graphical Data Display Manager Base NL Feature 
Graphical Display And Query Facility 

Graphics Attachment Support Programming 

Host Displaywriter Document Interchange 

IBM BASIC/VM 

IBM High-Accuracy Arithmetic Subroutine Library 
IBM 3812 Pageprinter VM Support 

Info Center/1 

Interactive Instructional Presentation System 
Interactive System Productivity Facility 
Interactive System Productivity Facility/PDF 
NetView Volume 1 


4=Return 5=Execute 


9=Sort(prodid) 10=Sort(desc) 11= 12=Cursor 


Figure 41. INSTFPP Panel 4 
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SOINSO2 INSTFPP PRODUCT SELECTION PANEL © Line 37 of 68 


co a enn SD Gee Oe ED GR GER GED SEN SES GES com mee fey com nS GD Gm Bem OSE OER ee Mey tee Mr Cm ee RE Se Se SE OE SEE WY SUE OE RE SE Oe ee Gee Se SE GS ST eS ee OE Ee SA GD Ge Se EEE SO GES GUD Gee Ge SE OY Ge ey ee Ge es 


Type an X next to the product(s) you want to instal] 
When you have finished, press the PF5 key to begin 
the installation process. 


5664204 02 NetView Volume 2 
5664204 #803 NetView Volume 3 
5734PL3 OS PL/1 Optimizing Compiler and Libraries 
5734LM5 OS PL/1 Transient Library 
5664293 Overlay Generation Language 
5664199 Page Printer Formatting Aid 
5796PNQ Pascal/VS 
_ 5664298 PC Bond 
5664312 Print Services Access Facility 


5664198 B Print Services Facility/VM Base 
5664198 S Print Services Facility/VM 3800 
5664198 V Print Services Facility/VM 3820 


PF1=Help 2= 3=Quit 4=Return 5=Execute 6= 
PF7=Backward 8=Forward 9=Sort(prodid) 10=Sort(desc) 11= 12=Cursor 


===> 


Figure 42. INSTFPP Panel 5 


SOINSO2 INSTFPP PRODUCT SELECTION PANEL Line 49 of 68 


Type an X next to the product(s) you want to install 
“When you have. finished, press the PF5 key to begin 
the installation process. 


5664309 Professional Office System 

5664309 PA Professional Office System Applications Support Feature 
5668AAA Query Management Facility 

5748XP1 RSCS Networking, Version 1 


5664188 
57 48XXJ 
5664191 
5664319 
5746AM2 
5664318 
5664364 
5798DMY 


RSCS Networking, Version 2 

Structured Query Language/Data System 

Virtual Machine Monitor Analysis Program 

Virtual Machine/Personal Computer Host Server 

Virtual Storage Extended/Virtual Storage Access Method 
VM/Interactive Productivity Facility 

VM Batch Facility 

VM File Storage Facility 


PF1=Help 4=Return 5=Execute 
PF7=Backward 8=Forward 9=Sort(prodid) 10=Sort(desc) 11= 12=Cursor 


=== = > 


Figure 43. INSTFPP Panel 6 
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SOINSO2 INSTFPP PRODUCT SELECTION PANEL Line 61 of 68 
Type an X next to the product(s) you want to install 
When you have finished, press the PF5 key to begin 
the installation process. 


5748RC1 VM/Pass-through Facility 

5796PNA VM Real Time Monitor 

5664283 VM/Integrated System-Productivity Facility 

5664291 VMBACKUP Management System 

5664292 VMTAPE Management System 

5668958 VS COBOL II 

5668806 VS FORTRAN 

5664281 3270 PC File Transfer 
PF1=Help 2= 3=Quit 4=Return 5=Execute = 
PF7=Backward 8= 9=Sort(prodid) 10=Sort(desc) 11= 12=Cursor 

===> 


Figure 44. INSTFPP Panel 7 


Specifying Products Directly 


If you enter arguments, the INSTFPP panels do not appear on your screen. You can specify product 
specification codes by listing them as you find them in the FEATURE$ PRODUCTS file. Omit hyphens or 
other punctuation marks, and leave one blank between each code. You can specify up to 130 characters, 
including the command and options, on the CMS command line. 


To install all the licensed programs available, specify the ALL option. 


After Running INSTFPP 


After you run INSTFPP, do the following steps: 


I. 


Execute manual installation and verification procedures as indicated in the product Memo to Users if 
necessary. 


. Tailor product-dependent files as indicated in the product Memo to Users if necessary. 


. Resave CMS if licensed programs that you installed loaded files to the MAINT 19E minidisk (the 


Y-disk). 


. Consider placing file directory information for shared, read/only minidisks into a DCSS using the 


SAVEFD command. Refer to VM/XA SP CP Command Reference. 
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Notes: 


1. INSTFPP cannot properly restore minidisks accessed as read/only extensions with a subset defined. 
INSTFPP reaccesses minidisks as read/only extensions with no subset specification. 


2. INSTFPP leaves the tape drive containing the optional feature product tape attached as virtual address 
181. 


3. A console file is created during the installation process to > record terminal BHI and is spooled | to the 
MAINT reader when ee is complete. | 


PROD LEVEL File 
INSTFPP updates a file named “PROD LEVEL” on the MAINT 319 minidisk with the results of each 
licensed program installation. 


Example 


Figure 45 shows an example of a PROD LEVEL file. 


5748XXB Display Management System (DMS/CMS) 
VER 1 REL 2 MOD 0 

Time and date of entry: 20:25:25 30 Sep 1986 
*** Product installed and verified successfully 


5799AXX 3277 Graphics Attachment Support PRPQ (GASP) 
VER 1 REL 3 MOD 0 

Time and date of entry: Zi:1/:25 30 Sep 1986 

*** Product installed; manual verification required 


Figure 45. Sample PROD LEVEL File 


Messages 


Each licensed program entry in the PROD LEVEL file has an update message associated with it. The 
possible update messages and their explanations are: 


*** Product installed and verified successfully 


Explanation: The licensed program was installed correctly, and the product was verified successfully. 


*** Product files loaded; see the Memo to Users to complete installation 


Explanation: The licensed program files have been loaded successfully. Refer to the product Memo to Users 
printed by INSTFPP. This memo tells you how to complete the installation of the product and then verify 
that it installed correctly. In some cases, the product Memo to Users refers to other documentation. 


*** Product installed; manual verification required 


Explanation: The licensed program was installed, but it was not verified automatically. Refer to the product 
Memo to Users printed by INSTFPP. This memo tells you how to make sure the licensed program installed 
correctly. In some cases, the product Memo to Users refers to other documentation. 
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*** Product installed; verification failed 


Explanation: The licensed program was installed, but the automatic verification failed. Try to install the 
licensed program again after correcting any problems; if it does not verify correctly, contact your support 
personnel. 


*** Product Installation EXEC failed; RC = rc 


Explanation: The product installation EXEC failed, and the return code passed back by this EXEC to 
INSTFPP is rc. Refer to the product Memo to Users or product installation EXEC prolog to see what this 
return code means. If you cannot fix the problem, contact your support personnel. 


Rerunning INSTFPP 


If any licensed programs do not install correctly, take the following steps: 


1. Try to solve the problem by using the console log, product Memo to Users, the PROD LEVEL file, and 
other product-specific documentation. 


or 2. Ready the tape. 
| ( 3. Invoke INSTFPP. 
4. Reinstall products that did not install correctly, plus any products that have these products as 


prerequisites. 


After you install each licensed program, follow the instructions in the product Memo to Users to verify that 
it has installed correctly (unless it was automatically verified during installation.) 
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ITASK 


ITASK EXEC 


ITASK EXEC is a tool used primarily in the Starter System installation procedure. It invokes other EXECs 
and commands to perform installation and system generation tasks, to let you complete the installation 
process with fewer entries and decisions. | 


Format | 


The format of the ITASK EXEC is: 


ITASK ALLI1 
ALL3 
CP 
CMS | 
DUMPVIEW 
| GCS" _ 
HELP a ge 
AMENGHLP | 
UCENGHLP 
CPSRC 
LOAD CMSSRC 
DVSRC 
ALL 
| Attons| 
CP ; 
LANG CMS — 
GCS ae 
HELP 
CMSSRC 
cP : [NOASSEM] 
M 
sad GCS a 
GCS 
ALL ed 
DMSNGP 
ASSEMBLE HCPBOX 
HCPRIO 
HCPSYS 
ALLOCATE 
BASEIDS 
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LOAD 
invokes SPLOAD EXEC to load files from the product tapes, to the minidisks specified in SPLOAD 
PROFILE. Some LOAD operands may perform additional operations. 


Warning: The disk addresses in the SPLOAD PROFILE, user directory, 56643082 $PPF, and SETUP 
EXEC, and the default addresses used by the ITASK EXEC must all match. If you change an address in 
any one of these places, you must change it in all the others. We recommend that you do not change 
any addresses. 


ALLI 
loads all the CP and dump viewing facility object, delta, and apply files from volume 1 of the 
product tape. 


ALL3 
loads all the CP, CMS, and dump viewing facility source files from volume 3 of the product tape. 


CP 
checks to ensure that the SYSGEN tools are loaded, and then loads the the CP object code, DELTA, 
and APPLY files from the product tape. 


CMS 
checks to ensure that the SYSGEN tools are loaded, and then loads the IOCP files, CMS SYSTEM, 
CMS DELTA, CMS APPLY, and CMS BASE tape files from the product tape; then invokes the 
ASMGEND EXEC to build the starter system assembler. 


DUMPVIEW 
loads the dump viewing facility object, DELTA, and APPLY files from the product tape. 


GCS 
loads the GCS INTERFACE and GCS OBJECT tape files from the product tape. 


HELP 
loads the HELP FILES tape file from the product tape. First the mixed case American English 
HELP files are loaded to the 19D disk; then they are copied to the 19C disk and converted to upper 
case. 


AMENGHLP 
loads the mixed-case American English HELP files to the 19D disk. 


UCENGHLP 
loads the mixed-case American English HELP files directly to the 19C disk, then converts them to 
upper case. 


CPSRC 
loads the CP SOURCE tape file from the product tape. 


CMSSRC 
loads the CMS SOURCE tape file from the product tape. 


DVSRC 
loads the DUMPVIEW SOURCE tape file from the product tape. 


LANG 
indicates that national language files are to be loaded from a national language feature tape. 


ALL 
loads the entire contents of the national language feature tape. 


ALLOBJ 


loads only the object (non-source) code. This consists of the following tape files: CP OBJECT, CMS 
BASE, and GCS OBJECT. 
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CP 
loads only the CP OBJECT tape files. 


CMS 
loads only the CMS BASE tape files. 


GCS 
loads only the GCS OBJECT tape files. 


HELP 
loads only the HELP FILES tape file. 


CMSSRC | 
loads only the CMS SOURCE tape file. 


BUILD 
invokes VMFBLD EXEC to build the specified nucleus. 


CP | 
assembles the CP sample files; invokes the VMFBLD EXEC to build the CP nucleus. 


If the NOASSEM option is used, the CP sample files are not assembled. This option assumes that 
these files are already assembled individually. 


CMS 
invokes the VMFBLD EXEC to build the CMS nucleus. 


GCS 
modifies a copy of the GCS loadlist (GCSLOAD EXEC) and changes the default configuration file 
entry (GCS) to match the file name of the GCS configuration file, systemname GROUP (if you do 
not specify a file name, the default is GCS); renames the file type of the configuration file from 
GROUP to ASSEMBLE; assembles the configuration file; and invokes the VMFBLD EXEC a a 
procedure to build and save the GCS nucleus. Me o 


ASSEMBLE 
assembles the specified sample file: 


ALL 
assembles the HCPBOX, HCPRIO, and HCPSYS files (but not the DMSNGP file). 


DMSNGP 
assembles only the DMSNGP file. 


HCPBOX —_ 
assembles only the HCPBOX file. oY 


HCPRIO 
assembles only the HCPRIO file. 


HCPSYS 
assembles only the HCPSYS file. 


ALLOCATE 
loads in sample directory from the product tape, prompts for a new password to be used by both 
MAINT and Operator, replaces the starter system directory with this sample directory, and then loads 
the following files from volume | of the product tape. 


; Ae ms : 
; 


File Contents 
SYSGEN TOOLS $DASD$ CONSTS, DISKMAP EXEC 
SYSTEM SAMPLES. DVM PROFILE, SAMPNSS EXEC, starter IOCP, FILECONV 


SAMPEXEC, CONVSYS SAMPCMDS, CONVUCR SAMPCMDS, 
COMPSCAN SAMPEXEC, COMPSCAN SAMPLIST, VMFUECP 
EXEC, VMFUECMS EXEC, VMFUEDV EXEC 
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CPLOC SAMPLES HCPBOX ASSEMBLE, HCPRIOXA ASSEMBLE, 33nn DIRECT, 33nn 
" DISKMAP, HCPSYSmn ASSEMBLE | 
( : CMSLOC SAMPLES DMSNGP ASSEMBLE, DMSNGP TEXT, DMSNGP TXTUCENG 
After loading the files, the ITASK EXEC renames the following files: 
Preload Name Name After Load 
33nn DIRECT ~ USER DIRECT 
33mn DISKMAP | USER DISKMAP 


HCPSYSxx ASSEMBLE HCPSYS ASSEMBLE 
The placement of these files is determined by the SPLOAD PROFILE. 


The ITASK EXEC also allocates space on the DASD volumes identified in the $ALLOC$ user ID in the 
CP directory. 


You are prompted for the real address of each DASD volume, and you have the option to SKIP any 
are volume that you do not want to allocate. Allocation is done according to the entries in the directory; all 
( space not specifically allocated is allocated as PERM. 


BASEIDS 
issues the CMS FORMAT command to format the remaining minidisks defined in the base CP directory 
which did not have code loaded to them during the installation process. 


The minidisks formatted during this procedure are: 
e AUTOLOG 191 

_ ¢ CMSBATCH 195 

(_ ¢ DISKACNT 191 
= ¢ EREP 191 


¢ MAINT or XAMAINT 192, 194, 19C, 19D, 19E, 201, 291, 293, 294, 36E (PVM), 391, 392, 393, 394, 
423, 490, 491, 492, 495, 49C, 49D, 501, 591, 592, 593, 594, 595, 596, 59E, 691, 692, 791, 892, 895, 
896, 89E 


Note: If you issue ITASK BASEIDS from a user ID other than MAINT or XAMAINT, that user 
ID’s minidisks are formatted instead. 


( : ¢ OPERATNS 191 
| ° RSCS 191. 


Also, a PROFILE EXEC is placed on the EREP 191 and DISKACNT 191 minidisks during this 
procedure. 


Messages and Return Codes 


DMSWTK002E File fn ft [fm] not found 
Return Code: 28 


DMSWTKO003E Invalid option: option 
Return Code: 24 


DMSWTKO0O08E Device vdev invalid or nonexistent 
Return Code: 36 © 
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DMSWTKOS50E 
Return Code: 24 


DMSWTKO70E 
Return Code: 24 


DMSWTKO095E 
Return Code: 100 


DMSWTK360E 
Return Code: 0 


DMSWTK961E 
DMSWTK965I 


Return Code: 20 


DMSWTK966R 
Return Code: 0 


DMSWTK967R 
Return Code: 0 


DMSWTK968I 


Return Code: 0 


Parameter missing after function 


Invalid parameter parameter 
Invalid address vstor 
Invalid response response 


There are class class files in the device 
You may wish to tailor the following files before nuclei generation: 


HCPBOX ASSEMBLE | o~ 
HCPRIO ASSEMBLE Lo 
HCPSYS ASSEMBLE a 
DMSNGP ASSEMBLE 

USER DIRECT 


Do you wish to have the HELP files converted to uppercase? 


Hers 
[ : 

Type: (Yes) or No re, 
The following minidisks defined in the base CP directory will be formatted: 
userid 192 userid 49C | 
userid 194 userid 49D 
userid 19C userid 501 
userid 19D userid 4591 as 


userid 19K userid 392 ae 
userid 201 userid 593 ee” 
userid 291 userid 594 

userid 293 userid 595 

userid 294 userid 596 

userid 391 userid 59E 

userid 392 userid 691 

userid 393 userid 692 

userid 394 userid 791 

userid 423 userid 892 

userid 490 userid 895 

userid 491 userid 896 

userid 492 userid 89E 

userid 495 
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DMSWTK9691 A PROFILE EXEC has successfully been copied to {EREP’s|DISKACNT’s} 191 minidisk. 
Return Code: 0 


DMSWTK970I Formatting user id vdevno minidisk 
Return Code: 0 


DMSWTK981R What is the real address of your volume volume? 
Return Code: 0 


DMSWTK982R Type: Real address or SKIP 
Return Code: 0 


DMSWTK983E Violation of CMS naming convention found in args 
Return Code: 24 


DMSWTK13101 Do you want to format minidisks; AUTOLOGI 191, CMSBATCH 195, DISKACNT 191, 
user id 36K (PVM), EPEP 191, OPERATNS 191, and RSCS 191? 


Return Code: 0 
DMSWTK8005R_ = Type: 1 (Yes) or 0 (No). 


For a complete explanation of each message, refer to VM/XA SP System Messages and Codes Reference. 
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The Patch Facility 


The patch facility is used to make changes to TEXT files in the CP or CMS nucleus. 


The patch facility lets you maintain (patch) object code when neither source nor object deck replacements are 
available. These patches are a temporary solution to object code problems until you receive a replacement 
file from IBM. 


The procedure for maintaining object code is similar to that for maintaining source code. However, with 
object code, rather than changing source and reassembling the source file, you'll apply changes directly to the 
TEXT files as the nucleus is generated. 


Controlling Patches 


You control patches with three kinds of files: 


e AUXiliary files = 
e Update files. a 


Note: As with source updates to base ASSEMBLE files, patches to TEXT files do not cause any changes to 
the original TEXT files because temporary TEXT files are created. The temporary TEXT files are 
used to generate the nucleus, then erased. 


Here’s a description of the files and elements you'll need to understand to make object code patches. 


Control File This file contains 4 MACLIB statement and a list of file types, one for each level of AUX 
file. It also contains the text deck qualifier for each level. A keyword, TX$, must follow 
the last AUX file name on a line to flag the AUX file or update as containing text patches. 


Note: The patch facility creates a temporary control file with a file name of $$$5TUP$$ 
CNTRL. The use of this name for any control file is restricted to the patch facility. 


AUX File This file contains a list of the file types of update files. The update files contain source 
updates to source or updates to TEXT files. | 


Note: Any entry in the AUX file which contains the name of a patch update file must 
contain the TX$ control word between columns 8 and 13. 


Load Map This function contains information from both the map of CSECT external symbol ( 
resolution and service level information. The map also includes local patches and <—— 
co-requisite and prerequisite information. The date and time listed in the load map for each 
patched text file are the original date and time, not the date and time when the temporary 
deck was created. 


TEXT File This file contains the data elements that have been assembled by the customer for source 
maintenance or provided (already assembled) by IBM for object maintenance. You use it to 
create executable modules. These files contain APAR corequisite and prerequisite 
information. 


Note: The patch facility creates temporary text files with a file type of TXT$TUP$. Only 
the HCPLDR EXEC (the loader EXEC) may use this file type. 
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Example of a Patch Update File 


The following are the functionally equivalent HCPLDR EXEC control statements contained in the update 
file, which will appear as comments to the update program: 


* CO-REQ: nnannnnnn 
* PREREQ: nnnnnnnn 
NAME CSECTname 

* 

VER disp data 

REP disp data 

ICS name size 


MA TM MAL A 
4 F * F F F 


These statements are equivalent to the loader control statements in content. HCPLDR EXEC reformats the 
statements to make them acceptable to HCPLDR module. 


Note: Pre-allocated patch areas are not required because the loader can expand any CSECT in the 
executable module as it is created from the text files. Addressability to the expanded area is available 
in every CSECT although space for a patch area need not be. This results in reduced size of 
executable modules because patch areas do not consume space until they are used. 


Here’s an explanation of each statement: 
Note: Each statement below must be preceded by “./” . 


* NAME CSECTname 
This statement identifies which CSECT in a text file is to be patched. It is optional. The 
CSECTname must match the SD name from the ESD for the module. If you omit this statement, 
the CSECT with the same name as the file name is patched. 


* * comment 
This is a comment to the loader EXEC and is optional. 


* * CO-REQ: nrnnnnnnn 
This is an APAR requisite comment. Use it to indicate dependencies on APARs or other patches. 
The following format is suggested: 


./ * * CO-REQ: VM23418 
./ * * PREREQ: VM23418 


When there are no dependencies, put “NONE” after the keywords CO-REQ: and PREREQ.:. 


* VER disp data 
This statement verifies that the patch is applied at the correct point in the executable module. 
You need at least one verify statement for each patch. As much data as is required to assure 
uniqueness should be verified. For example, you may include a verify of the date in the copyright 
constant of the module prologue. 


The disp is the displacement, in hex, of the location to be patched in the CSECT. 


The data is the existing old data in hex to be replaced. This may be up to eleven four digit fields 
separated by commas. A comma may not follow the last halfword. 


* REP disp data 
This statement contains the data to replaced in the CSECT. 


The disp contains the displacement in hex of the location to be patched in the CSECT. 


The data is the new data in hex that will replace the existing data. This may be up to eleven 
four-digit fields separated by commas. A comma may not follow the last half-word. 
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Patch Facility 


* ICS name size 
This statement expands the CSECT in the executable module (nucleus). This statement is 
optional. 


The name is the same name used in the NAME statement. If a NAME statement is not present, 
name must match the file name of the patch file in which it is included. 


The size is the total size required for the CSECT. 


The following are the functions used in the object service process. 
¢ VMFBLD EXEC 
The VMFBLD EXEC invokes the loader EXEC (that is, HCPLDR EXEC). 
¢ HCPLDR EXEC 
This EXEC exploits the Verify and Replace capabilities of the loader module. 
It gathers TEXT files into an executable nucleus based upon control information. 


Note: This function does not change previous HCPLDR command syntax except to include a = 
“NOPATCH” option. c 


This EXEC provides the same level of control for local service, when source is not available, as is 
currently provided for source file updates. This means that the nucleus-generation process automatically 
locates and tries to reapply a local patch each time a replacement update file arrives from IBM. 


This results in one of two possibilities: 
1. The local fix is applied and you receive replacement update files. You must then evaluate whether: 
— The local fix is obsolete. 


If the replacement update file contains the APAR fix that replaces the local fix, then you can fe Xs 
remove the local fix by removing the object update from the AUX file or the control file. Se 


— The local fix is still needed. 


If the replacement update file does not contain an APAR fix that replaces the local fix, then you 
will leave the local fix in place. 


2. The local fix is not applied and you receive replacement service files. You must then evaluate 
whether: 


— The local fix 1s obsolete. 


If the replacement update file contains an APAR fix that replaces the local fix, you just accept eS 
the replacement deck. 


— The replacement update file does not contain an APAR fix equivalent to the local fix. 
If the replacement update file does not contain an APAR fix that replaces the local fix, you may: 
— Choose the APAR fix as more important, and just accept the replacement update file. 


— Fix both problems by accepting the replacement update file and reworking the local fix. 


Compatibility with HCPLDR 


A temporary composite TEXT file is created by the loader EXEC; the composite TEXT file is a copy of the 
IBM-supplied TEXT file with the patch update file merged into it. The temporary text deck will have the 
same date and time as the original. The NAME statement is not included in a composite TEXT file. The 
NAME statement is used only to identify the correct CSECT. When this statement is not present, the patch 
update file changes the CSECT with the same name as the TEXT file. 
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A composite TEXT file may include: 


e The patch AUX file entry Gncluded as a comment), placed following existing comments, but before the 
first ESD statement. 

¢ An APAR requisite comment, placed after the AUX file comment, but before the first ESD statement. 

¢ An optional ICS statement, placed after an APAR requisite statement, but before the first ESD 
statement. 

e Required VER and REP statements, placed after any ICS statement, but before the first RLD statement 
or before the END statement if there is no RLD statement in the TEXT deck. 

¢ Patch update file comments, included as they are encountered. 


For each NAME statement in a patch update file and for each patch update file without a NAME statement, 
a VERIFY statement must be present or the patch is not accepted by the loader EXEC. The composite 
TEXT file will have the same file name and its file type will be TXT$TUP$. 


The loader EXEC works the same way as the current HCPLDR command works. The EXEC goes through 
the load list one module at a time, using the CNTRL file to determine the file type. For each temporary 
composite TEXT file, the EXEC provides a file name with the file type TXTSTUP$. In addition, the EXEC 
a creates a $$$TUP$$ CNTRL file that contains the file type qualifier (STUP$ that produces a file type of 
( TXTS$TUP$) of the composite TEXT file created by the loader EXEC. 


The loader EXEC invokes the HCPLDR MODULE by passing it a temporary control file named $$$TUPS$ 
along with other parameters. All temporary files such as TXT$TUP$ or $$$TUP$$ have a file mode of 3; 
these files are erased automatically as soon as they are used. 


Usage Notes 


cme The patch facility is provided to give you: 
( | ¢ The same control that you have with source updates and IBM update file updates. 
¢ The same tracking capability so that no previously applied patch will be lost or ignored when IBM 
replacement service is applied based upon the contents of the load map. 
The following guidelines are recommendations to follow: 
1. Keep each fix to a TEXT file in a separate update file. 
This also applies to source update fixes; each source update fix should be in a separate update file. 


Each fix should have an alphanumeric number that is the file type of the update file. 


2. Keep all local fix descriptions for the same TEXT file in the same AUX file, unless a fix applies to a 
different control file level. 


Local fixes for the same TEXT file should not be distributed over AUX files (different control file levels) 
arbitrarily. Local service should be easily distinguished from IBM service and should always be applied 
last. Local service can be distributed over separate control files for the purpose of maintaining different 
service levels with a single structure of AUX and update files. Each level can be built from a different 
control file containing only the desired level identifiers. 


3. Never place local patches in AUX files from IBM. In other words, keep your local service separate from 
IBM service. Local service should be easily distinguished from IBM service and should always be applied 
last. 


4. Patches to TEXT files should be applied only when no source file is available. Mixing source updates 
and TEXT file patches for the same module will lead to confusion and is not recommended. 
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Example of Local Service to TEXT Files 


The following is an example of a control structure containing patches at more than one level. This is an 
appropriate use of the patch facility. 


PRODSYS CNTRL L3 AUXLCL3 
P1 AUXP1 
TEXT AUXXA 


CMSSYS CNTRL L2 AUXLCL2 
L3 AUXLCL3 
P2 AUXP2 
P1 AUXP1 
TEXT AUXXA 

TESTSYS CNTRL L1 AUXLCL1 
L2 AUXLCL2 
L3 AUXLCL3 
P3 AUXP3 
P2 AUXP2 
Pl AUXP1 
TEXT AUXXA 


HCPXYZ AUXLCLI PATCH3 TX$ APAR3 — 


HCPXYZ PATCH3 . ‘ * VER 24 4780,C204 
* REP 24 4700 


HCPXYZ AUXLCL2 PATCH2 TX$ APAR2 


HCPXYZ PATCH2 ./ * VER 254 47F0,6062 
./ * REP 254 4700 

J * VER 260 5810,7042,5010 

* REP 260 58F0,7042,50F0 


HCPXYZ AUXLCL3 PATCH1 TX$ APARI 


HCPXYZ PATCHI1 ./ * VER 254 4740,6062 
y * REP 254 47FO 


HCPXYZ 
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Example of Local Service to ASSEMBLE Files 


The following is an example of a control structure containing a temporary patch over a local source update. 
Although this works, it is not recommended. Whenever source code is available, you should use source 
updates instead of patches. 


XASYS CNTRL L1 AUXLCL1 TX$ 
P1 AUXP1 
TEXT AUXXA 
HCPXYZ AUXLCLI TEMPO2 TX$ PROB1 
LCFIX5 TX$ APAR2 
HCPXYZ TEMP02 ./ * VER 24 4780,C204 
./ * REP 24 4700 
HCPXYZ LCFIXS5 ./ ADD 12340000 
XYZLOOP TM  FLAG,X‘O1' CHECK COMPLETE 
BO DONE EXIT LOOP 


HCPXYZ TXTLI 
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PRELOAD MODULE 


The preloader is a utility program that runs under CMS. It collects multiple text files and reformats them 
into a single text file. The function of the preloader is similar to that of a linkage editor, but the output is in 
standard text file format and does not include multiple CSECTS. _ 


A program can be developed using separate assembly modules that reference each other. The preloader can 
then be used to combine the assembled text files into a single loadable text file. | 


Format 


The format of the PRELOAD command 1s: 


PRELOAD loadlist [control | 


where: 


loadlist | 
specifies the file name of an EXEC on the caller’s A-disk or read-only extension contaiming records that 
define input to the preloader. Each of these records contains the file name and optionally the file type of 
an input text file. The format of each loadlist record defining an input file must be: 


&l &2 filename filetype 


control 
optionally specifies the file name of a CNTRL file residing on one of the caller’s accessed disks. The 
format and interpretation of the CNTRL file is the same as that for the VM/SP VMFLOAD utility. It 
normally contains file types in priority sequence to be used for selecting input files if file types are not 
included in the loadlist file. The IBM-supplied control files are described in Chapter 7, “How VM/XA 
System Product Uses Control Files and Update Files” on page 377. 


Note: PRELOAD ignores records that have a PTF update level identifier. It then searches for the next 
lower level identifier to determine the file type of the input text file. PRELOAD also ignores any 
options in the loadlist. 


Input 


The preloader gets input file names from the loadlist. The file type for each input file is determined in one of 
three ways: 


1. If the loadlist record for a given input file includes a file type entry, that file type is used to locate the 
record. 


2. If the loadlist record does not contain a file type, and a ‘control’ parameter was specified on the 
PRELOAD command line, the file type constructed is in the format TXTxxxxx. In this case xxxxx 1s 
the highest control level identifier in the control file for which a file can be located on the caller’s 
accessed disks. 


3. If no file type is specified on the loadlist entry, and a control file has not been specified on the 
PRELOAD command line, then the default file type value is TEXT. 


Note: Input files are located by scanning the caller’s disks in their access order. All input files must be on 
accessed disks. 
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Output 


The preloader output consists of two files written to the caller’s A-disk: 
1. fn TEXT 
2. fn MAP. 


The file name for each of these files is the same as that specified for the input loadlist file. If either of these 
files already exists on the caller’s A-disk, the new copy replaces the old one. 


TEXT File 


The output TEXT file is a merged and linked composite of the input files. The first CSECT or private code 
section in the input expands to contain all input files. Its length is the sum of the lengths of the input files, 

rounded up to doubleword multiples between sections. Input TXT records of non-zero length are relocated 
and written to the output file. 


The output RLD is a translated and relocated collection of all input RLD records. No sorting is done by the 
preloader. In general, each output ESD, TXT, and RLD entry appears in the same order as the 
corresponding input entry. ADCON and VCON fields are relocated within their TXT records. ORG 
statements that cause relocatable constant fields to overlay or be overlaid may cause results that differ from 
results obtained with a loader that completes TXT data loading prior to relocating ADCONs and VCONS. 


MAP File 
The output MAP file is a printable record of preloader processing, similar to a load map. The first line of 
the map contains: 

e Output text file name 

e Residence volume label and volume device address 

e Date and time of file creation. 
The next section of the map is a listing of the control file Gf any) used. The remainder of the map contains, 
in processing order, a section for each input file. Each of these sections consists of: 

e File name, file type, file mode of input file 

e Residence volume label and virtual device address 

e Input file’s creation date and time 


e Any invalid input records. 
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Messages 


PRELOAD issues the following CMS messages: 


DMSPREOOIE No file name specified 

DMSPREO002E File fn ft fm not found 

DMSPRE104S Error nz reading file fn ft fm from disk 
DMSPRE105S Error nn writing file fn ft fm on disk 
DMSPREI109S Virtual storage capacity exceeded 
DMSPRE183E Invalid {CONTROL|AUX} file control card 
DMSPRE234E Error in LOAD LIST file fn ft fm[; no input] 
DMSPRE235E Error n in input text file fn ft [fm] 
DMSPREZ236E Unresolved external reference(s) encountered 
DMSPRE237E Duplicate external symbol(s) encountered 
DMSPRE238E Preloader processing error 


For a complete explanation of each message, refer to VM/XA SP System Messages and Codes Reference. 
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SAMGEN EXEC 


The SAMGEN EXEC creates a segment that contains the simulated VSE modules necessary to support 
Sequential Access Method (SAM) data management (DTFSD), the ESERV utility program, and Virtual 
Storage Extended/Virtual Storage Access Method (VSE/VSAM). 


To install this segment, called CMSBAM, use the SAMGEN EXEC procedure. 


Before you invoke SAMGEN EXEC, you need to define a virtual machine large enough to contain 
CMSBAM. To provide room for the loader tables, the size of the virtual machine should be at least 512K 
greater than the location at which you intend to save CMSBAM. However, you must not define your 
storage larger than the address at which you loaded CMSDOS. 
SAMGEN EXEC performs the following operations: 
e Fetches the simulated VSE phases from the CMSBAM DOSLIB file, which is supplied as part of VM 
e Loads the simulated phases at the designated address 


e Assigns a storage protection key of X'F' 


e Saves the segment. 
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SAMPNSS EXEC 


The SAMPNSS EXEC defines named saved systems. 


Format 


SAMPNSS CMS CMSXA 
GCS 
CMSINST 
HELP 
CMSDOS 
CMSBAM 
.CMSVSAM 


CMSAMS 


where: 


CMS CMSXA 
creates named saved systems for CMS and CMSXA at pages E00 — FFF. 


GCS 
creates a named saved system for GCS at pages 0-6 (exclusive) and 400 — SFF (shared). 


CMSINST 
creates a saved segment for CMSINST at pages C00 — C4F. 


HELP | ao 
creates a saved segment for HELP at pages C50 —C9F, in the INSTHELP segment space. ie 


CMSDOS 
creates a saved segment for CMSDOS at pages B00 — BOF, in the DOSBAM segment space. 


CMSBAM 
creates a saved segment for CMSBAM at pages B10 — B3F, in the DOSBAM segment space. 


CMSVSAM 
creates a saved segment for CMSVSAM at pages BAO — BFF (shared) and A30— AFF (exclusive), in the 
DOSBAM segment space. a 


CMSAMS ne 
creates a saved segment for CMSAMS at pages B40 — B9F (shared) and A00— A2F (exclusive), in the 
DOSBAM segment space. 
The SAMPNSS EXEC: 
1. Defines the named saved systems or segments that you request 
2. Queries CP about the status of the named saved systems or segments 


3. Displays the status of the named saved systems or segments as shown below: 


OWNERID FILE TYPE CL RECS DATE TIME FILENAME FILETYPE 
CMSMAINT nnnn NSS A nnnn mm:dd-— hh:mm _- nss NSS 
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Messages 


( For information on error messages and codes, see VM/XA SP System Messages and Codes Reference. 


HCPNSD440I {Named Saved System (NSS)|Saved segment} systemname was successfully defined in fileid 


fileno. 
HCPNSS440I {Named Saved System (NSS)|Saved segment} systemname was successfully saved in fileid 


fileno. 
Unrecognized Parameters passed — parm! parm2 


Explanation: SAMPNSS detected an error in the specified parameter. 
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| SETUP EXEC 


Use the SETUP EXEC to access all the disks where the service EXECs and the product parameter file might 
be found. The SETUP EXEC does not access the disks needed by the service EXECs; each EXEC does that 
for itself (usually by invoking VMFSETUP). 


The access order is: 


Moi 
[ence LOCAL ik 


Note: No C- or D-disk is accessed. If you have a C-disk accessed, release it. You do not need to release 
your D-disk. 


Address 


Format 


The format of the SETUP EXEC is: 


SETUP oe’ 
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SPLOAD EXEC 


The SPLOAD EXEC loads files from the product tapes according to the load instructions contained in 
SPLOAD PROFILE. SPLOAD PROFILE is described following this section. 


Format 


The format of the SPLOAD EXEC is: 


SPLOAD element { fn i | 


where: 


group element 
is a tape file identifier that SPLOAD EXEC uses to locate the entry in SPLOAD PROFILE that contains 
the load instructions for this tape file. 


fn [ft] 
form a file specification template. By default, both are set to asterisks (*), meaning all files within a tape 
file. However, they may be set to a specific file name and/or file type to selectively load specific files 
from a tape file to a minidisk. 


SPLOAD PROFILE 


In the sample SPLOAD PROFILE, data entries are organized by format number (see definition below), and 
format number sets are separated by comment lines. A comment line begins with a slash asterisk (/*). Each 
data entry in SPLOAD PROFILE has the following syntax: 


group element user id address’ format volume _ fileno 


where: 


group element 
is a tape file identifier that identifies the profile entry containing the load instructions for this tape file. 


user id 
is the owner of the minidisk to which the tape file contents are loaded. This information is used only if 
SPLOAD EXEC must LINK and ACCESS the minidisk in order to load the file. 


address 
is the minidisk address to which the tape file is loaded. 


format 
is the tape format. SPLOAD PROFILE contains a complete load table for each tape format, describing 
the locations of the files on the product tapes. SPLOAD EXEC selects the appropriate entries in the 
profile depending on the user’s tape format. 


volume 
is the product tape volume on which the particular tape file resides. 


fileno 
is the relative tape file number (location) of the specified tape file on the particular product tape volume. 
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! Volume 1 


1 
Memo Files MAINT 191 XASP20V1 1 2 

Install Tools MAINT 191 XASP20V1 1 3 

Sysgen Tools MAINT 193 XASP20V1 1 4 

System Samples MAINT 191 XASP20V1 1 5 

CPLOC Samples MAINT 295 XASP20V1 1 6 

CMSLOC Samples MAINT 395 XASP20V1 1 7 

CP Object MAINT 194 XASP20V1 1 8 

CP Putapply MAINT 192 XASP20V1 i 9 

CP Putdelta MAINT 294 XASP20V1 1 10 

CP Corapply MAINT 291 XASP20V1 1 11 

CP Cordelta MAINT 291 XASP20V1 1 12 

DUMPVIEW Object MAINT 193 XASP20V1 1 13 a 
DUMPVIEW Putapply MAINT 392 XASP20V1 1 14 7 
DUMPVIEW Putdelta MAINT 293. +XASP20V1 1 15 

DUMPVIEW Corapply MAINT 391 XASP20V1 1 16 

DUMPVIEW Cordelta MAINT 391 XASP20V1 1 17 

! Volume 2 

CMS Base MAINT 193 XASP20V2 2 2 

CMS Putapply MAINT 392 XASP2O0V2 2 3 

CMS Putdelta MAINT 293 ~=XASP20V2 2 4 c 
CMS Corapply MAINT 391  XASP20QV2 2 5 ( 
CMS Cordelta MAINT 391 XASP20V2 2 6 hd 
IOCP Files MAINT 193 XASP20V2 2 7 

CMS System MAINT 190 XASP20V2 2 8 

GCS Object MAINT 595 XASP20V2 2 9 

GCS Interface MAINT 193. XASP20V2 2 10 

GCS Putapply MAINT 592 XASP20V2 2 11 

GCS Putdelta MAINT 596 XASP20V2 2 12 

GCS Corapply MAINT 491 XASP20V2 2 13 

GCS Cordelta MAINT 491 XASP20V2 2 14 

AMENGHLP Files MAINT 19D XASP20V2 2 15 —_ 
UCENGHLP Files MAINT 19C XASP20V2 2 15 ae 


Figure 46 (Part | of 2). Sample SPLOAD PROFILE 
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SPLOAD 


! Volume 3 

! 

CP Source MAINT 394 XASP20V3 3 2 

CMS Source MAINT 393 = XASP20V3 3 3 

DUMPVIEW Source MAINT 393 XASP20V3 3 4 

! 

! 

Risto R is ets se ate oe ooo ee eeu e aaa ees eeu * / 
[* 6250 BPI VM/XA NLS Feature Tape 7 
/* age are Re Se wee a Stal Sa Rl et a a ee hs Na og a ie oe ys eae et y 
ie af 
CMS Base MAINT 193 R2MONLS 1 2 

CP Object MAINT 194 R2MONLS 1 3 

HELP Files | MAINT ? R2MONLS 1 4 

CMS Source MAINT 393 R2MONLS 1 5 

DUMMY Object MAINT XXX  R2MONLS 1 6 

GCS Object MAINT 595  R2MONLS 1 7 

if ‘) 
iy */ 


Figure 46 (Part 2 of 2). Sample SPLOAD PROFILE 


Warning: The disk addresses in the SPLOAD PROFILE, user directory, 56643082 $PPF, and SETUP 
EXEC, and the default addresses used by the ITASK EXEC must all match. If you change an address in any 
one of these places, you must change it in all the others. We recommend that you do not change any 
addresses. 


Usage Notes 


1. SPLOAD must do a tape rewind each time it is invoked to make sure that the proper product tape is 
mounted and to be able to position the tape to the proper tape file. If the incorrect tape is mounted then 
SPLOAD will prompt for the proper product tape. 


The first tape file on each product tape contains a header file named $TAPE$ HEADER. The first line 
of this file must be in the following format: 


TAPENO = n 3; TAPEFORMAT = ff 
where n is the relative tape number and / is the tape format (e.g. RIM05500). 


2. SPLOAD expects that the tape drive being used is ATTACHed at virtual address 181. If not, SPLOAD 
will not be able to continue. 


3. SPLOAD will ACCESS the target minidisk at an unused mode letter nearest the end of the alphabet. It 
will use Z if all modes are used. 


4. SPLOAD restores the minidisk access order to its original state just before exiting. However, SPLOAD 
will not be able to recreate mode extension situations. 


5. If SPLOAD does a LINK to a minidisk, followed by an ACCESS to that disk and receives a return code 
of 100 from the ACCESS, an attempt will be made to FORMAT the disk. 


SPLOAD will provide a minidisk label to FORMAT which will consist of the first three characters of the 
user ID which owns the minidisk, concatenated with a 3-digit minidisk address. If the minidisk address is 
four digits long, then only the first two characters of the user ID will be used. 


Note: For user ID MAINT, the default characters used will be either MNT or MT, depending on the 
size of the minidisk address. 
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SPLOAD 


Messages and Return Codes 


DMSWTK002E 
Return Code: 28 


DMSWSL032E 
Return Code: 24 


DMSWSLOSOE 
Return Code: 24 


DMSWSL062E 
Return Code: 20 


DMSWTK070E 
Return Code: 24 


DMSWSG095E 
Return Code: 100 


DMSWSL252E 
Return Code: 24 


DMSWSL409I 
Return Code: 0 


DMSWSL737R 
Return Code: 0 


DMSWSL963E 
Return Code: 24 


DMSWSL964R 


Return Code: ) 


DMSWSL986I 
Return Code: 0 


For a complete explanation of each message, refer to VM/XA SP System Messages and Codes Reference. 


Jn ft not found 


Invalid file type /t 


Parameter missing after value 


Invalid character char in fileid fn 


Invalid parameter parameter 


Invalid address vaddr 


Invalid file name file name 


Loading fn ft to the vdev disk attached to user id 


Enter the minidisk address for the group element 


keyword value not found in fn ft fm 


Wrong tape mounted; mount product tape n | 
Press ENTER when the correct tape is mounted or type QUIT 


Unable to restore ACCESS to mdisk 
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UPDATE Command 


Use the UPDATE command to modify program source files. The UPDATE command accepts a source 
input file and one or more files containing UPDATE control statements and updated source records; then it 
creates an updated source output file, an update log file indicating what changes, if any, were made, and an 
update record file if more than a single update file is applied to the input file. 


Format 


The format of the UPDATE command is: 


UPDATE fal ee ie [fn2 [ft2 — [(options ... [)]] 


co options: 
( REP | SEQ8 ie | ke 


NOREP NESEQ8 NOINC NOCTL 


STK TERM DISK STOR 
NOSTK NOTERM PRINT NOSTOR 


/ [OUTMODE fim] 


where: 


( _ Jnl ftl fml 


is the file identifier of the source input file. The file must consist of 80-character card image records with 
sequence fields in positions 73 through 80 or 76 through 80. If the file type or file mode is omitted, 
ASSEMBLE and AI are assumed, respectively. 


fn2 ft2 fm2 
is the file identifier of the update file. If the NOCTL option is in effect, this file must contain UPDATE 
control statements and updated source records. The default file identifier is fnl1 UPDATE Al. If the 
CTL option is specified, this file must be a control file that lists the update files to be applied; the default 
file identifier is fn] CNTRL AI. 


Mee st 


REP 
( creates an output source file with the same file name as the input source file. If the output file is placed 
on the same disk as the input file, the input file is erased. 


NOREP 
retains the old file in its original form, and assigns a different file name to the new file, consisting of a 
dollar sign ($) plus the first seven characters of the input filename (fn1). 


SEQ8 
specifies that the entire sequence field (columns 73 through 80) contains an eight-digit sequence number 
on every record of source input. 


NOSEQ8 
specifies that columns 73 —75 contain a three-character label field, and that the sequence number is a 
five-digit value in columns 76 — 80. 


Note: Source files sequenced by the CMS editor are sequenced, by default, with five-digit sequence 
numbers. 


INC 
increases sequence numbers in columns 73 through 80 in each record inserted into the updated output 
file, according to specifications in UPDATE control statements. 
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puts asterisks (********) in the sequence number field of each updated record inserted from the update 
file. | 


CTL 
specifies that fn2, ft2, and fm2 describe an update control file for applying multiple update files to the | 
source input file. | 


Note: The CTL option implies the INC option. 


NOCTL 
specifies that a single update file is to be applied to the source input file. 


OUTMODE fm 
specifies that UPDATE writes the files it creates on the fm disk. UPDATE writes the files as outlined in 
the note below. If you do not specify a filemode when using OUTMODE, the file mode number defaults 
to “1”. This disk must be an accessed CMS read/write disk or UPDATE terminates. | 


Note: UPDATE takes the following steps to determine the disk upon which it places output files. The 
search stops as soon as one of the following steps is successful: 


1. If you specify the OUTMODE option, then UPDATE places the output files on the specified 
disk. That disk must be read/write. If you accessed the disk as a read only extension, then 
UPDATE displays the following message: 


DMSUPDO37E DISK fm IS READ-ONLY 


2. If the disk on which the original source file resides is read/write, then UPDATE places the 
output files on that disk. 


3. If that disk is a read-only extension of a read/write disk, then UPDATE places the output 
files on that particular read/write disk. 


4. If neither of the other steps is successful, then UPDATE places the output files on the 
primary read/write disk (the A-disk). 


STK 
stacks information from the control file in the CMS console stack. STK is valid only if the CTL option 
is also specified and is useful only when the UPDATE command is executed in an EXEC procedure. 


NOSTK 
does not stack control file information in the console stack. 


TERM 
displays warning messages at the terminal whenever a sequence or update control card error is 
discovered. (Such warning messages appear in the update log, whether they are displayed at the terminal 
or not.) 


NOTERM 
suppresses the display of warning messages at the terminal. However, error messages that terminate the 
_ entire update procedure are displayed at the terminal. 


DISK 
places the update log file on disk. This file has a file identifier fn UPDLOG, where fn is the filename of 
the file being updated. 


PRINT 
prints the update log file directly on the virtual printer. 


STOR 
specifies that the source input file is to be read into storage and the updates performed in storage prior to 
placing the updated source file on disk. This option is meaningful only when used with the CTL option 
since the benefit of increased processing speed is realized when processing multiple updates. STOR is the 
default when CTL is specified. 
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NOSTOR 
specifies that no updating is to take place in storage. NOSTOR is the default when single updates are 
being applied (CTL is omitted from the command line). 


Update Control Statements 


The UPDATE control statements let you insert, delete, and replace source records, as well as resequence the 
output file. 


All references to the sequence field of an input record refer to the numeric data in columns 73 — 80 of the 
source record, or columns 76 — 80 if NOSEQ§8 1s specified. Leading zeros in sequence fields are not required. 
If no sequence numbers exist in an input file, a preliminary UPDATE with only the “./ S” control statement 
can be used to establish file sequencing. 


Sequence numbers are checked while updates are being applied; an error condition results if any sequence 
errors occur in the update control statements, and warnings are issued if an error is detected in the 
sequencing of the input file. Any source input records with a sequence field of eight blanks are skipped, 
without any indication of a sequence error. Such records may be replaced or deleted only if they occur 
within a range of records that are being replaced or deleted entirely and if that range has limits with valid 
sequence numbers. There is no means provided for specifying a sequence field of blanks on an UPDATE 
control statement. 


Control Statement Formats: 


All UPDATE control statements are identified by the characters “./” in columns | and 2 of the 80-byte 
record, followed by one or more blanks and additional, blank-delimited fields. Control statement data must 
not extend beyond column 50. 


SEQUENCE Control Statement 


Use the sequence control statement to resequence the updated source output file in columns 73 — 80 Gf SEQ8 
is specified), or in columns 76 — 80 with the label placed in columns 73 — 75 (if NOSEQ$ is specified). 


The format of the SEQUENCE control statement is: 


-/ S [seqstrt [seqincr [label]]] | 


where: 


seqstrt 
is a one- to eight-digit numeric field specifying the first decimal sequence number to be used. The default 
value is 1000 if SEQ8 is specified and 10 if NOSEQ§8 is specified. 


seqincr 
is a one- to eight-digit numeric field specifying the decimal increment for resequencing the output file. 
The default is the “seqstrt” value. 


label 
is a three-character field to be duplicated in columns 73 —75 of each source record if NOSEQ8 is 
specified. The default value is the first three characters of the input filename (fn/). 


If you use the SEQUENCE statement, it must be the first statement in the update file. If any valid control 
statement precedes it, the resequence operation is suppressed. 
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When the sequence control statement is the first statement processed, the sequence numbers in the source file | 


are checked and a warning message is issued for any errors. If the sequence control statement is processed 
after updates have been applied, no warning messages will be issued. | 


Each source record, including unchanged records from the source file and records inserted from the update 
file, is resequenced in columns 73 — 80 as it is written onto the output file. 


INSERT Control Statement 


Use the insert control statement to insert all records following it, up to the next control statement, into the 
output file. 


The format of the INSERT control statement is: 
./ I seqno [$ [seqstrt [seqincr]]] 


where: 


seqno 
is the sequence number of the record following which new records are to be added. 


is an optional delimiter indicating that the inserted records are to be sequenced by increments. 


seqstrt 
is a one- to eight-digit numeric field specifying the first decimal number to be used for sequencing the 
inserted records. 


seqincr 
is a one- to eight-digit numeric field specifying the decimal increment for sequencing the inserted records. 


All records following the “./ I” statement, up to the next control statement, are inserted in the output file 
following the record identified by the segno field. If the NOINC option is specified, each inserted record is 
identified with asterisks (********) in columns 73 —80. If either the INC or CTL option is specified, the 
records are inserted unchanged in the output file, or they are sequenced according to the segstrt and seqincr 
fields, if the dollar sign ($) key is specified. 


The default sequence increment, if the dollar sign is included, is determined by using one tenth of the least 
significant, nonzero digit in the seqno field, with a maximum of 100. The default seqstrt is computed as segno 
plus the default segincr. For example, the control statement: 


./ 1 2600 $ 2610 


causes the inserted records to be sequenced XXX02610, XXX02620, and so forth (NOSEQ8 assumed here). 
For the control statement: 


./ 1 240000 $ 


the defaulted seqgincr is the maximum, 100, and the starting sequence number is 240100. SEQ8 is assumed, so 
the inserted records are sequenced 00240100, 00240200, and so forth. 


If either INC or CTL is specified but the dollar sign is not included, whatever sequence number appears on 
the inserted records in the update file is included in the output file. 
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DELETE Control Statement 


Use the delete control statement to delete one or more records from the source file. 


The format of the DELETE control statement is: 
./ D  seqnol [seqno2] [$] 


where: 


seqnol 
is the sequence number identifying the first or only record to be deleted. 


seqno2 
is the sequence number of the last record to be deleted. 


is an optional delimiter indicating the end of the control fields. 


All records of the input file, beginning at seqno/, up to and including the segno2 record, are deleted from the 
output file. If the segno2 field is omitted, only a single record is deleted. 


REPLACE Control Statement 


Use the replace control statement to replace one or more input records with updated records from the update 
file. 


The format of the REPLACE control statement is: 
./ R seqnol [seqno2] [$ [segstrt [segincr]]] 


where: 


seqnol 
is the sequence number of the first input record to be replaced. 


seqno2 
is the sequence number of the last record to be replaced. 


is an optional delimiter key indicating that the substituted records are to be sequenced incrementally. 


seqstrt 
is a one- to eight-digit numeric field specifying the first decimal number to be used for sequencing the 
substituted records. 


segincr 
is a one- to eight-digit numeric field specifying the decimal increment for sequencing the substituted 
records. 


All records of the input file, beginning with the segno/ record, up to and including the seqno2 record, are 
replaced in the output file. They are replaced with the records that follow the “./ R” statement in the update 


file, and precede the next control statement. 


As with the “./ D” (delete) function, if the segno2 field is omitted, only a single record is replaced, but it may 
be replaced by more than a single inserted record. The “./ R” (replace) function is performed as a delete 
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followed by an insert: thus, the number of statements inserted need not match the number deleted. The 
dollar sign ($), seqstrt, and segincr processing is identical to that for the insert function. 


COMMENT Statement 
Use the comment statement to insert comments into the file. 


The format of the COMMENT statement is: 


where: 
* 


indicates that this is a comment statement and is only copied into the update log file. 


Summary of Files Used by the UPDATE Command 


The following discussion shows input and output files used by the UPDATE command for a: 
e Single-level update 
e Multilevel update 


¢ Multilevel update with an auxiliary control file. 


Single-Level Update 


fn ASSEMBLE 7 fin ASSEMBLE 
fn UPDATE fn UPDLOG 
update fn 


where: 


fn ASSEMBLE 
is the source input file. 


jn UPDATE 
contains UPDATE control statements and updated source input records. 


$fn ASSEMBLE 
is the updated source file, incorporating changes, additions, and deletions specified in the update file. 
The output file type is always the same as the file type of the input file. These default file types and file 
modes can be overridden on the command line; for example: 


update testprog cobol b fix cobol b (rep a 


results in a source file TESTPROG COBOL B being updated with control statements contained in the 
file FIX COBOL B. The output file replaces the existing TESTPROG COBOL B. 
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fn UPDLOG 
contains a record of updates applied. If you do not want this file written on disk, specify the PRINT 
option. 


Multilevel Update 


fn ASSEMBLE $fn ASSEMBLE 
fin CNTRL fin UPDLOG 
fin UPDTABC fn UPDATES 
fn UPDTIXYZ 


update fn (ctl 


where: 


( fn ASSEMBLE 
7 is the source input file. 


fn CNTRL 
is the control file that lists updates to be applied to the source file. These default file types and file 
modes can be overridden on the command line; for example: 


update acct pliopt a test cntrl a (ctl @ 


results in the file TEST CNTRL being used by the UPDATE command to locate the update files for 
ACCT PLIOPT. 


( : fn UPDTABC 
po fn UPDTXYZ 
are update files containing UPDATE control statements and new source records. These files must have 


file names that are the same as the source input file. The first four characters of the file type must be 
“UPDT”. The UPDATE command searches all accessed disks to locate the update files. 


$fn ASSEMBLE 
is the updated source file, incorporating changes, additions, and deletions specified in the update files. 
The file type is always the same as the file type of the source input file. 


—_— fn UPDLOG 
: contains a record of updates applied. If you do not want this file written on disk, specify the PRINT 
option. 


fn UPDATES 
summarizes the updates applied to the source file. 


The CONTROL FILE (7 CNTRL) may not contain UPDATE control statements. It may only list the file 
types of the files that contain UPDATE control statements. This control file contains the records: 


TEXT MACS CMSLIB 
TWO UPDTABC 
ONE UPDTXYZ 


where UPDTABC and UPDTXYZ are the file types of the update files. The UPDATE command applies 
these updates to the source file beginning with the last record in the control file. Thus, the updates in fn 
UPDTXYZ are applied before the updates in fn UPDTABC. 
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When you create update files whose file types begin with “UPDT”, you may omit these characters when you 
list the updates in the control file; thus, the CNTRL file may be written: 


TEXT MACS CMSLIB 
TWO ABC | 
ONE XYZ 


TEXT, TWO, ONE: The first column of the control file consists of an update level identifier, which may be 
from one to five characters long. These identifiers are used by VM updating procedures, like the 
VMFHASM EXEC, to locate and identify text decks produced by multilevel updates. 


MACS: The first record in the control file must be a MACS record that contains an update level identifier 
(TEXT) and, optionally, lists up to nine macro library (MACLIB) file names. 


UPDATE uses the information provided in the MACS card and the update level identifier only when the 
STK option is specified. This information is, however, required in the CNTRL file. 


Multilevel Update with Auxiliary Control File 


fn ASSEMBLE 

fin CNTRL $fn ASSEMBLE 
fn UPDTABC fn UPDLOG 
fin UPDTXYZ fn UPDATES 
fin AUXLIST 

fn FIXO1 

fn FIX02 


ooo 


update fn (ctl 


fn ASSEMBLE, fn CNTRL, fn UPDTABC, fn UPDTXYZ, $fn ASSEMBLE, fn UPDLOG, and fn 
UPDATES are used as described, for “Multilevel Update”, except that the CNTRL file contains: 


TEXT MACS CMSLIB 

TWO UPDTABC 

ONE UPDTXYZ 

TEXT AUXLIST —_ 


AUX in the file type AUXLIST indicates that this is the file type of an auxiliary control file that contains an 
additional list of updates. The first three characters of the file type of an auxiliary control file must be 
“AUX”; the remaining character(s) (to a maximum of five) may be anything. The filename must be the same 
as the source input file. 


- An auxiliary file may also be specified as: 


XXXXx AUX 


in the control file. For example, the record: 
FIX TEST AUX 


identifies the auxiliary file fn AUXTEST. 


Note that if you give an auxiliary control file the file type AUXPTF or an update level identifier of AUX, 
the UPDATE command assumes that it is a simple update file and does not treat it as an auxiliary file. 
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Preferred AUX File 


A preferred AUX file may be specified. A preferred AUX file contains the version of an update that applies 
to your version of the source file. (There may be more than one version of the same update if there is more 
than one version of the source file. For example, you need one version for the source file that has a system 
extension program product installed, and you need another version for the source file that does not have a 
program product installed.) 


When you specify an auxiliary control file, you can specify more than one file type. The first file type 
indicates a file that UPDATE uses only on one condition: the files that the second and subsequent file types 
indicate do not exist. If they do exist, this AUX file entry is ignored and no updating is done. The files that 
the second and subsequent file types indicate are preferred because, if they exist, UPDATE does not use the 
file that the first file type indicates. For example, assume that the file fn ASSEMBLE does exist. The 
control file MYMODS CNTRL: 


TEXT MACS MYMACS CMSLIB OSMACRO 
MY2 AUXTEST 
MY1  AUXMINE AUXTEST 


and the command: 
update fn assemble * mymods cntr] (ctl @ 


would result in UPDATE finding the preferred auxiliary control file fn AUXTEST, and therefore not using 
jn AUXMINE to update fn ASSEMBLE. UPDATE would then proceed to the MY2 AUXTEST entry and 
update “fn ASSEMBLE” with the updates listed in fn AUXTEST. It is assumed that AUXTEST and 
AUXMINE list similar but mutually exclusive updates. 


The search for a “preferred” AUX file will continue until one is found or until the token is an invalid file 
type; that is, less than four or more than eight characters. This token and the remainder of the line are 
considered a comment. 


Jn FIXO1 and fn FIX02 are update files containing UPDATE control statements and new source records to 
be incorporated into the input file. When update files are listed in an auxiliary control file, they can have any 
file type you choose, but the file name must be the same as the source input file. The update files, as well as 
the AUX file, may be on any accessed disk. These are indicated in fn AUXLIST as follows: 


FIXO2 
FIXO1 


The updates are applied from the bottom of the auxiliary control file. Thus, fn FIX0O1 is applied to the 
source file before fn FIX02. Since the auxiliary control file is listed at the bottom of the control file, these 
updates are applied before UPDTXYZ and UPDTABC. 


Additional Control File Records 
In addition to the MACS record, the file types of update (UPDT) files, and the file types of auxiliary control 
(AUX) files, a control file may also contain: 


¢ Comments. These records begin with an asterisk (*) in column 1. Comments are also valid in AUX files. 


¢ PTF records. If the characters PTF appear in the update level identifier field, the UPDATE command 
expects the second field to contain the file type of an update file. The file type may be anything; the file 
name must be the same as the source input file. 


¢ Update level identifiers not associated with update files. 
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The following example of a control file shows all the valid types of records: 


* Example of a control file 
ABC MACS MYLIB 

TEXT 

004 UPDTABC 

003 XYZ 

002 AUXLIST1 

001 LIST2 AUX 

PTF TESTFIX 


The STK Option 


The STK (stack) option is valid only with the CTL option and is meaningful only when the UPDATE 
command is invoked within an EXEC procedure. 


When the STK option is specified, UPDATE stacks the following data lines in the console stack: 


first line: * update level identifier 
second line: * library list from MACS record 


The update level identifier is the identifier of the most recent update file that was found and applied. For 
example, if a control file contains: 
TEXT MACS CMSLIB OSMACRO TESTMAC 


OFA UPDTOFA 
PFA UPDTOFA 


and the UPDATE command appears in an EXEC as follows: 


UPDATE SAMPLE (CTL STK &READ VARS &STAR &TEXT &READ VARS 
&STAR &LIB1 &LIB2 &LIB3 &LIB4 


then the variable symbols set by the READ VARS statements have the following values if the file SAMPLE 
UPDTOFA is found and applied to the file SAMPLE ASSEMBLE: 


Symbol Value 


&STAR . 

&TEXT OFA 
&LIB1 CMSLIB 
&LIB2 OSMACRO 
&LIB3 TESTMAC 
&LIB4 nul | 


The library list may be useful to establish macro libraries in a subsequent GLOBAL command within the 


EXEC procedure. If no update files are found, UPDATE stacks the update level identifier on the MACS 
record. | 


Message 


FILE fn ft fm, REC #n = update control statement 


Explanation: This message is displayed when the TERM option is specified and an error is detected 1 in an 
update file. It identifies the file and record number where the error is found. 
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Return Codes 


The UPDATE command issues the following return codes: 


Return Code Possible Causes 


¢ No file name specified 
e Input file sequence error 


e Sequencing overflow 


e Sequence increment is zero 
e Sequence error introduced in output file 


bo 


¢ Premature EOF of file; sequence number not found 
e Missing PTF file 
e ./s not first card in input file; card ignored 


¢ Invalid char in sequence field 
e Sequence number not found 
e Invalid update file control card 


e Invalid option 

¢ Invalid mode 

e¢ Option specified twice 

¢ Conflicting options 

e¢ Invalid parameter 

e Option STK invalid without CTL 


e File not found 
e File UPDATE CMSUT1 fm already exists 


e File is not fixed, 80-character records 


bo 
o@) 


> 


ho 


e Missing or duplicate MACS card in control file 
e Invalid file control card 


¢ Disk is read-only 
e Disk not accessed 


wo 
il 


as 
© 


e No update files were found 


e Insufficient storage to begin update 
¢ Insufficient storage to complete update 


—— 
k 


100 e Error reading file from disk 
e Error writing file on disk 
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UTILITY EXEC 


The UTILITY EXEC provides occasionally-used installation utility functions: 


e Printing the system definition files | 
e Creating a stand-alone service utility tape for either or both DSF and DDR 
¢ Writing a backup [PLable copy of the CP nucleus to tape . 
¢ Creating CP load list 
e Generating the following utilities: 
ADDMAP CPEREPXA CPFMTXA DIRECTXA 
DUMPLOAD DUMPSCAN GENIMAGE HCPCCU 
HCPLDR HCPSADMP IMAGELIB IPL DDRXA 
MAP MONWRITE OVERRIDE PRTDUMP 
RETRIEVE SCAN TRACERED 3CARD LOADER 
Format | : yee 


The format of the UTILITY EXEC is: 


UTILITY PRSAMPLE 
ALL 
UTILTAPE DSF 
DDR 


NUCTAPE 
-CPLOAD 


CPFMTXA 
HCPSADMP a 


ALL 
CPEREPXA 

DIRECTXA 

DUMPLOAD 

GENIMAGE 

HCPCCU 

HCPLDR 

IMAGELIB 

IPL DDRXA 

MONWRITE a 
OVERRIDE a 
RETRIEVE - 
3CARD LOADER 


ALL 

ADDMAP 

DUMPSCAN 
DVFGEND MAP 

PRTDUMP 

SCAN 

TRACERED 
DTYPE vdev 
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where: 


PRSAMPLE 
prints the following system definition files: 


USER DIRECT 
DMSNGP ASSEMBLE 
HCPRIO ASSEMBLE 
HCPSYS ASSEMBLE. 


These files are spooled to the system printer. The minidisk(s) containing these files must be accessed 
before using the PRSAMPLE operand. 


UTILTAPE 
creates a tape containing any or all of the following stand-alone utility programs: 


¢ Device Support Facility (DSF) 
¢ DASD Dump/Restore program (DDRXA). 


Each IPLable program is written as a separate tape file, with one or more tape marks separating the 
pts programs. Therefore, when you IPL a program off the tape, you may have to IPL more than once to 
( bypass the tape marks. 


NUCTAPE 
writes a backup IPLable copy of the CP nucleus to tape. 


CPLOAD 
creates the CP load list, which has a file name of CPLOAD and a file type of EXEC. 


GEN 
creates any of the following stand-alone utility programs on disk from their associated object modules 


( (text decks): 

duit? CPEREPXA MODULE, the error recording module 

CPFMTXA MODULE, the module that CP-formats minidisks for CP use 
DIRECTXA MODULE, the user directory program 

DUMPLOAD MODULE 

GENIMAGE MODULE 

HCPCCU MODULE 

CMS version of the system loader (HCPLDR MODULE) and the stand-alone version of the system 
loader (HCPLDR LOADER) 

Stand-alone dump program (HCPSADMP) 

IMAGELIB MODULE 

370-XA version of the DASD DUMP RESTORE program (IPL DDRXA) 
MONWRITE MODULE 

OVERRIDE MODULE 

RETRIEVE MODULE 

3CARD LOADER. 


UTILITY GEN ALL creates all the programs listed except CPFMTXA MODULE and HCPSADMP. 


DVFGEND 
creates any or all of the following modules: 


ADDMAP MODULE 
DUMPSCAN MODULE 
MAP MODULE 
PRTDUMP MODULE 
SCAN MODULE 
TRACERED MODULE. 
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DTYPE vdev 
issues a DIAGNOSE code X'24' for the specified virtual device address, uses the returned information 
to look up the DASD type in the $DASD$ CONSTS file, and returns that information to the terminal (if 
UTILITY DTYPE is issued from the terminal) or to the program stack (if UTILITY DTYPE is called 
by another EXEC). 


Only VM/XA-installation-supported DASD types are represented in SDASD$ CONSTS. The 
information returned is a single line consisting of three fields: 


¢ DASD type and model 
¢ The proper representation of the given DASD model to the CPFORMAT program. 


If the virtual device address is invalid, non-existent, or addresses an unsupported device type, a non-zero — 
return code is displayed. 


The UTILITY DTYPE function is intended primarily for use by installation-related utilities. 


Usage Notes 


1. If you specify ALL for the GEN option, UTILITY generates all of the utilities listed under the GEN eo, 
option, except CPFMTXA MODULE and HCPSADMP. If you specify ALL for the DVFGEND 
option, UTILITY generates all of the utilities listed under the DVFGEND option. 


2. UTILITY creates HCPLDR MODULE and LOADER by assembling the associated files. It generates 
all other modules from the associated text deck. The text deck must be on an accessed disk before 
UTILITY is run. You must run SETUP EXEC, then VMFSETUP EXEC with the CP ALL parameters, 
to establish the appropriate minidisk access order. 


——. 


Messages and Return Codes 


DMSWUT002E File fn ft not found 
Return Code: 28 


DMSWUTOSOE Parameter missing after value 
Return Code: 24 


DMSWUTO070E Invalid parameter parameter es 
Return Code: 24 | Ge 


, 


DMSWUTO95E Invalid address vaddr 
Return Code: 24 


DMSWUT338E Generating a new /n ft will not be attempted 
Return Code: 28 


DMSWUT340E _sfile name has not been created 
Return Code: 24 


DMSWUT97I1E Unable to locate fn ft 
Return Code: 24 
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DMSWUT9721 _—s fn ft fm spooled the printer 
Return Code: 0 


DMSWUT973R Enter the minidisk address where the IPL decks were loaded 
Return Code: 0 


DMSWUT974I Unable to find IPL decks on the minidisk you indicated 
Return Code: 0 


DMSWUT975I Moving fn ft to tape 
Return Code: 0 


DMSWUT976I The fn ft program is on tape file number number 
Return Code: 0 


DMSWUT980I An IPLable CP nucleus now exists on tape 
Return Code: 0 


DMSWUT986I Unable to restore ACCESS to mdisk 
Return Code: 0 


For a complete explanation of each message, refer to VM/XA SP System Messages and Codes Reference. 
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VMFAPPLY EXEC 


Use the VMFAPPLY EXEC to create auxiliary control files for the PTFs you want to apply to VM/XA 
System Product. 


Format 


The format of the VMFAPPLY EXEC is: 


VMFAPPLY prodid |compname] [updateid| [(options ... [)]] 


options: 
PUT SETUP EXCLUDE CHECK. LOG 
COR NOSETUP NOEXCLUDE NOCHECK NOLOG 

where: -_ 
prodid | 

is the product to be serviced. The prodid for VM/XA System Product Release 2 is 56643082. 
compname 

is the component to be serviced. The names for the VM/XA System Product Release 2 components are 

CP, CMS, GCS, and DV. 
updateid 

is the file type of the auxiliary control files. It should match a file type listed in the CNTRL file. If you _ 

do not specify an update ID, VMFAPPLY will use the update ID in the product parameter file. ‘a ‘\ 
options 

PUT 

indicates that you are applying program update service. PUT is the default. 
COR 
indicates that you are applying corrective service. 
SETUP 
specifies that a new minidisk access order will be set up. SETUP is the default. ie 
/ 
NOSETUP We. 


specifies that a new minidisk access order will not be set up. You must set the correct access order 
up yourself. 


EXCLUDE 
means that PTFs listed in the exclude list will not be applied. EXCLUDE is the default. 


Note: If two PTFs are in the same text deck, you cannot exclude the first unless you also exclude 
the second, even if you list the first one on the exclude list. This restriction applies because 
the first PTF is considered to be a prereqisite for the second PTF. 


If you list the first PTF in the exclude list, but not the second, and if the second PTF appears 
in the apply list, both PTFs will be applied. You will receive an error message indicating that 
a PTF you wanted to exclude has been applied. 


NOEXCLUDE 
means that the exclude list will be ignored. 


CHECK 
means that all the checks that can be specified in the product parameter file will be performed. 


672 Installation and Service 


VMFAPPLY 


NOCHECK 
means that none of the checks that can be specified in the product parameter file will be performed. 


LOG 
specifies that error messages will be written both to the apply exception log and, if critical, to the 
terminal. LOG is the default. 


Notes: 
1. Non-critical messages are written only to the apply exception log, not to the terminal. 


2. Messages issued by the VMFOVER and VMSETUP EXECS, which VMFAPPLY invokes, are 
written only to the terminal, not to the apply exception log. 


NOLOG 
specifies that error messages will be written only to the terminal. 


Note: Options specified on the VMFAPPLY command override the options specified in the product 
parameter file. 


( How VMFAPPLY Works 


Figure 47 on page 674 is an overview of VMFAPPLY processing. 


Verifying the Apply List 


First, VMFAPPLY checks that the apply list is an appropriate apply list for program update service if you 
specified PUT, or for corrective service if you specified COR. If it is the wrong apply list, a message is 
issued. 


( Creating the Temporary PPF 


VMFAPPLY calls VMFOVER to create a copy of the appropriate component section of the product 
parameter file with overrides. If the product has more than one component and no component was specified, 
you are shown a list of components and asked to choose one. This copy is used instead of the original 
product parameter file. 


User Exit 


( | A user exit EXEC call for setup and cleanup is provided. The user EXEC is identified in the PPF by the 

Se ‘USEREXIT. tag. If an EXEC name follows the :USEREXIT. tag, that EXEC is called at the beginning and 
end of the VMFAPPLY EXEC. A separate EXEC can be provided for each component. VMFAPPLY 
passes parameters indicating the receive function and either setup or cleanup, and a return code from 
VMFAPPLY. Examples of such calls might be: 


MYEXEC VMFAPPLY SET-UP 
MYEXEC VMFAPPLY CLEAN-UP rc 
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$APP/$EXCLIST $PTFPART $PPF HCPxxx TXTptfno 


UM01895 HCPSCH H12345HP : : ‘ACPSCH TXT01927’ 
UM01896 HCPSCH TXT01927 : H3DD86HP PUT UMD1895 


UM01927 HCPALF TXT01927 PREREQ: VM29823 
esi moa CO-REQ: NONE 
ESD»... 


- VMFAPTXT 
VMFAPPLY - VMFAPNLS 
- VMFAPCOM 


AUXXA 
.FM UPDATE 
.DEPEND REQ 
-RENAME TEXT 
Figure 47. How VMFAPPLY Works 
aN 
Minidisk Accesses a 


VMFAPPLY invokes VMFSETUP (unless you specified NOSETUP) to save your current disk access order 
and build a new disk access order based on the product parameter file. (The product parameter file should 
be on a system disk accessed in your current search order, preferably your A-disk.) The new search order 1s: 


Task disk(s) 

Apply disk(s) 

Delta disk(s) | 

Local disk(s) 
Base disk(s) \ 
Build disk(s) 

System disk(s). 


The PTF Parts List 


VMFAPPLY obtains the first PTF entry from the apply list. If the entry is not on the exclude list, 
VMFAPPLY locates the PTF parts list by using the PTF number (seven characters) for file name and 
SPTFPART for file type. VMFAPPLY works through the PTF parts list one at a time and calls the specific 
part handler based on entries in the PPF part type list. 


After the PTF is applied, the file mode of the PTF parts list is changed to file mode 5. The procedure is 
repeated for each entry in the apply list. 


If the :CKUPD tag in the product parameter file is set to NO, and the file mode of the PTF parts list is 5, no 
processing is performed on the PTF. 
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Part-Specific EXECs 
VMFAPPLY invokes four part-specific EXECs (called part handlers). These part handlers are invoked once 
per part listed in the PTF parts list. The file type of the part determines which part handler is used. 
1. VMFAPAUX supports AUX files in the apply function. 
. VMFAPTXT supports text parts in the apply function. 
. VMFAPNLS supports text parts that require national language support in the apply function. 


_& Ww bv 


. VMFAPCOM is a common EXEC that insures the existence of parts that do not have specific processing 
but are listed in the PTF parts list. 


VMFAPAUX EXEC: VMFAPAUX is invoked once for each AUX file in each $PTFPART list processed 
during the execution of VMFAPPLY. 


VMFAPAUX locates the cumulative AUX file that contains the given PTF number. If this file does not 
exist, VMFAPAUX creates it. VMFPAUX validates the AUX file by commenting out duplicates which exist 
at lower AUX file levels. (These comments are located in the newly created file). If duplicate AUX files 
exist at higher levels, VMFAPAUX issues a message in the apply exception log. 


VMFAPAUX adds included PTFs to the $APPINCL list, adds depend entries to requisite update files, adds 
requisite update files that don’t have a file mode of 5 to the SAPPREQ list, and changes the file mode of the 
update file to 5. 


If the file contains new service, VMFAPAUX copies the new AUX file to a file with the file type listed in the 
‘UPDTID tag of the PPF. 


VMFAPCOM EXEC: VMFAPCOM is called to locate parts named in the PTF parts list for which no other 
specific processing is provided. Any part not found is listed in the exception log. The file mode is not 
changed to 5 because this is not a true apply (that is, no AUX structure is built) and there is no 
corresponding VMFBLD step. 


VMFAPTXT EXEC: VMFAPTXT first looks for an existing AUX file (for the specified module and at the 
specified update level) in the APPLY disk sequence. If the AUX file exists on the current apply disk, it is 
used as a base and additional entries are added to it. If the existing AUX file is on an earlier disk in the 
sequence, it is copied onto the current disk and used as a base. If none exists, a new file is created. 


VMFAPTXT gets the latest APAR entry (at the bottom of the text deck prolog) and checks the file mode of 
the update file. If the file mode number is 5, the APAR has already been applied. No further processing is 
required for that deck. If the file mode is 1, the entry is inserted at the top of the list of AUX file entries and 
the file mode number is changed to 5. If the update file is not found, it is created and a message is inserted 
in the apply exception log. 


The update files should be found on either the DELTA or the APPLY disks. If they exist on the DELTA 
disk, source service is available. If they are on the APPLY disk, they are OCO modules with object service 
only. Changing the file mode from x1 to x5 indicates that the APAR has been applied (listed in an AUX 
structure). All applied OCO updates have the file mode of the APPLY disk; and all applied source updates 
have the file mode of the DELTA disk. All updates that have not been applied, but that do exist on the 
DELTA or APPLY disk, have the file mode x1. 


The names (derived from APAR numbers) of update files in which prereq and coreq entries appear are 
entered in the requisite update files as DEPEND entries if the prerequisites and corequesites are in the same 
component as the update being applied. This will facilitate the backout of a bad fix and avoid leaving a 
dependent fix without its requisites. If the requisite file is not found, an entry is made in the apply exception 
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log. Requisites (prereq, coreq and/or ifreq) that are outside the component will be put in a list to be stored 
in the apply exception log. : 


VMFAPTXT proceeds to process all entries (working from bottom to top) in the text deck prolog until an 
already-applied entry (one whose file mode is 5) is encountered. Each succeeding entry from the text deck is 
inserted behind the last entry moved from the current text deck, but ahead of any entries that may have come 
from previous text decks. If the PTF number in any included entry is not in the apply list (minus the exclude 
list), a message is put in the apply exception log. 


If CK TXT is specified in the PPF, and if the top AUX entry is being applied at this time, (that is, not 
previously applied as indicated by file mode 5 on the update file that was listed in the text deck prolog) 
VMFAPTXT checks to see if the text deck is a full text deck or a shell only. If it is a shell only, the module 
name is added to the apply exception log as a missing text deck. If it is a full text deck, VMFAPTXT checks 
to see if this full text deck supersedes any listed in the apply exception log as missing text decks, in which 
case the module name is purged from the log. VMFAPTXT reads and writes directly to the log on the user’s 
A-disk. 


After all entries have been processed, a search is made for AUX files at higher control file entries. AUX files 
at these CNTRL file entries may represent local modifications or local text patches. The AUX file file name 
and file type are listed in the apply exception log along with all entries from the AUX file. 


Finally, VMFAPTXT searches the build lists in the BLD section of the PPF for the text deck file name. If 
the file name of the text deck being processed is found, a message is be put in the S3VMFAPP $ERRLOG 
indicating what build list the text deck was found in. This allows the user to easily determine what parts can 
be built using VMFBLD. 


After processing is complete, control returns to VMFAPPLY. 


If the name is not found in the list, the deck is copied with the rename file type from the third column of the 
PPF entry in the apply section to allow compatibility with current MODULE build support. If a deck with 
the rename file type already exists, the self-documenting prologs are compared to determine the superset deck 
that should contain all entries from the other deck. The superset deck is kept with the renamed file type 
either by retaining the existing renamed deck or by copying the new deck with the REPLACE option. 


After the copy, VMFAPTXT returns to VMFAPPLY. 


VMFAPNLS EXEC: VMFAPNLS first creates an AUX file name by concatenating the text file name with a 
1- or 2-character NLS suffix based on the text file type prefix. If the file type prefix is TAM, the language is 
mixed-case American English and the suffix is null. All other NLS file name suffixes are based on the file 
VMENLS LANGLIST S, which is resident on MAINT’s 190 disk and shown in Figure 48. 


American English 
Kanji 
Uppercase English 


Brazilian Portuguese 
French 
German 


Figure 48. VMFNLS LANGLIST File 


VMFAPNLS then looks for an existing AUX file (with the AUX file name created in the previous step and 
the specified update identifier) in the APPLY disk sequence. If the AUX file exists on the current APPLY 
disk, it is used as a base and additional entries are added to it. If the existing AUX file is on an earlier disk 
in the sequence, it is copied onto the current disk and used as a base. If none exists, a new file is created. 
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VMFAPNLS gets the latest APAR entry (at the bottom of the text deck prolog) and checks the file mode of 
the update file. If the file mode number is 5, the update has already been applied. No further processing is 
required for that deck. If the file mode is 1, the entry is inserted at the top of the list of AUX file entries and 
the file mode number is changed to 5. If the update file is not found, it is created and a message is inserted 
in the apply exception log. 


The update files should be found on either the DELTA or the APPLY disks. If they exist on the DELTA 
disk, source service is available. If they are on the APPLY disk, they are OCO modules with object service 
only. Changing the file mode from x1 to x5 indicates that the APAR has been applied (listed in an AUX 
structure). All applied OCO modules have the file mode of the APPLY disk; and all applied source modules 
have the file mode of the DELTA disk. All modules that have not been applied, but that do exist on the 
DELTA or APPLY disk, have the file mode x1. 


The names (derived from APAR numbers) of update files in which prereq and coreq entries appear are 

entered in the requisite update files as DEPEND entries if the prerequisites and corequesites are in the same | 
component as the update being applied. This will facilitate the the backout of a bad fix and avoid leaving a 
dependent fix without its requisites. If the requisite file is not found, an entry is made in the apply exception 

log. Requisites (prereq, coreq and/or ifreq) that are outside the component will be put in a list to be stored 

in the apply exception log. 


Messages indicating a requisite outside the component have a prefix of RO. These are not error messages, 
but informational messages issued so that you are sure to find all the requisites. 


VMFAPNLS proceeds to process all entries (working from bottom to top) in the text deck prolog until an 
already-applied entry (one whose file mode is 5) is encountered. Each succeeding entry from the text deck is 
inserted behind the last entry moved from the current text deck, but ahead of any entries that may have come 
from previous text decks. If the PTF number in any included entry is not in the apply list (minus the exclude 
list), a message is put in the apply exception log, and the PTF is added to a supplemental apply list (called fn 
$APPINCL) to be processed after the main apply list. 


If CK TXT 1s specified in the PPF, and if the top AUX entry is being applied at this time, (that 1s, not 
previously applied as indicated by file mode 5 on the update file that was listed in the text deck prolog) 
VMFAPNLS checks to see if the text deck is a full text deck or a shell only. If itis a shell only, the module 
name 1s added to the apply exception log as a missing text deck. If itis a full text deck, VMFAPNLS checks 
to see if this full text deck supersedes any listed in the apply exception log as missing text decks, in which 
case the module name is purged from the log. VMFAPNLS reads and writes directly to the log on the user’s 
A-disk. 


After all entries have been processed, a search is made for AUX files at higher control file entries. AUX files 
at these CNTRL file entries may represent local modifications or local text patches. The AUX file file name 
and file type are listed in the apply exception log along with all entries from the AUX file. 


Finally, VMFAPNLS copies the deck with the NLS file type indicated in the PPF. If a deck with the NLS 
file type already exists, the self-documenting prologs are compared to determine the superset deck that should 
contain all entries from the other deck. The superset deck is kept with the NLS file type either by retaining 
the existing NLS text deck or by copying the new deck with the REPLACE option. 


After the copy, VMFAPNLS returns to VMFAPPLY. 
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Return Codes 


VMFAPPLY issues the following return codes: 


0 
4 


No errors were encountered. 


Minor errors were encountered. Check $VMFAPP $ERRLOG. | 
ie There was syntax error in the command. | 


24 Unexpected tag in PPF. 


28 The required file was not found. 


An unrecoverable error was encountered. 
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VMFBLD EXEC 


Use the VMFBLD EXEC to build the nucleus during installation and to rebuild the nucleus after applying 
service. VMFBLD invokes $VMFPATS, which invokes the HCPLDR command. 


Format 


The format of the VMFBLD EXEC is: 


VMFBLD compname 


prodid | CORcompname | [bldlist] [(options ... DY} 


options: 


[oserur] [Nocueck | [Nou 


NOSETUP NOCHECK NOLOG 


where: 


prodid 
is the product to be serviced. The prodid for VM/XA System Product Release 2 is 56643082. 


compname 
is the component whose nucleus is to be rebuilt. 


If you are applying corrective service, type CORcompname. 
The names for the VM/XA System Product Release 2 components are CP, CMS, GCS, and DV. 


bidlist 
is the loadlist or buildlist for the nucleus or module you wish to rebuild. If you do not specify bidlist, all 
entries for the component will be processed. 
options 
SETUP 
specifies that a new minidisk access order will be set up. 


NOSETUP 
specifies that a new minidisk access order will not be set up. You must set the correct access order 
up yourself. 


CHECK 
means that all the checks that can be specified in the product parameter file will be performed. 


NOCHECK 
means that none of the checks that can be specified in the product parameter file will be performed. 


LOG 


specifies that error messages will be written both to the build exception log and, if critical, to the 
terminal. 


Notes: 
1. Non-critical messages are written only to the build exception log, not to the terminal. 


2. Messages issued by the VMFOVER and VMSETUP EXECs, which VMFBLD invokes, are 
written only to the terminal, not to the build exception log. 
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NOLOG 
specifies that error messages will be written only to the terminal. 


DISK 
specifies that the nucleus will be written to the target disk specified in the product parameter file. 
This must be the same disk specified on the SYSRES macro in the HCPSYS file (for CP) or the 
DMSNGP profile (for CMS). 


PUNCH 
specifies that the nucleus will be spooled to your virtual card reader. 


TAPE 
specifies that the nucleus will be written to tape 0182 in card image format. 


Note: Options specified on the VMFBLD command override the options specified in the product 
parameter file. 


How VMFBLD Works 


MAIN CNTRL LOADLIST _ $PPF TEXT a 


‘HCPXA CNTRL’ ‘CPLOAD EXEC’ :-MDA. 
TEXT MACS &1 &2 &3 HCPLDR ‘BLD. 


‘HCPLCK TXT01895’ 
‘ACPSCH TXT01927’ 


TEST AUXTST &1 &2 &3 HOPSYS CPLOAD 


‘ACPALF TXT01927’ 
LCL AUXLCL &1 &2 &3 HCPRIO tel 


TEXT AUXXA 


- CALL VMFBDNUC Mw 
- CREATE TEMP LOAD LIST 
VMFBLD - ESTABLISH SEARCH ORDER 
- CHECK REQUISITES 
- CALL HCPLDR 


Figure 49 (Part 1 of 2). How VMFBLD Works 
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PICK UP 
ENTRY FROM 


GO DOWN 


ONE LEVEL 
IN CNTRL 


‘HCPXA CNTRL’ 
TEXT MACS 
yyy AUXzzz 


IS 
HCPxxx AUXzzz 
THERE? 


TAKE 1st ENTRY 
IN AUX TO FIND 
OUT PTF NO. 


IS 
“HCPxxx TXTptfno’ 
THERE? 


SELECT TEXT 


‘HCPxxx TXTyyy’ 


COMPARE INFO OF 
HCPxxx AUXzzz 


V.S. 
‘HCPxxx TXTptfno’ 


ERROR 


SELECT TEXT 


‘ACPxxx TXTptfno’ 


Figure 49 (Part 2 of 2). How VMFBLD Works 
Creating the Temporary PPF 


VMFBLD calls VMFOVER to create a copy of the appropriate component section of the product parameter 
file with overrides. This copy is used instead of the original product parameter file. 


User Exit 


A user exit EXEC call for setup and cleanup is provided. The user EXEC is identified in the PPF by the 
‘USEREXIT. tag. If an EXEC name follows the :USEREXIT. tag, that EXEC is called at the beginning and 
end of the VMFBLD EXEC. A separate EXEC can be provided for each component. VMFBLD passes 
parameters indicating the receive function and either setup or cleanup, and a return code from VMFBLD. 
Examples of such calls might be: 


MYEXEC VMFBLD SET-UP 
MYEXEC VMFBLD CLEAN-UP rc 
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Minidisk Accesses 


VMFBLD then invokes VMFSETUP (unless you specified NOSETUP) to save your current access list and 
establish a new list based on the product parameter file. The new access order is: 


Task disk(s) 
Local disk(s) 
Apply disk(s) 
Delta disk(s) 
Base disk(s) 
Build disk(s) 
System disk(s). 


Part-Specific EXECs 


VMFBLD invokes the following part-specific EXECs: 
¢ VMFBDNUC creates a temporary load list and invokes the system loader. 
¢ VMFBDCPY copies the PTF-numbered TEXT deck to the BUILD disk. 


VMFBDNUC EXEC: VMFBDNUC creates a new (temporary) load list named $$$TLL$$ EXEC that 
contains both file name and file type to pass to HCPLDR. VMFBDNUC will call the VMFLDS MODULE 
to perform a search for the TEXT decks to load and create the temporary load list. 


When the temporary load list has been completed, the list of requisites within the component is processed as 
follows if the CHK REQ option has been specified. The list of requisite APARs is created by the VMFLDS 
MODULE. 


1. VMFBDNUC creates actual update file types by combining the numeric portion of the APAR number 
with the system and version level from the PPF. For example: 


APAR number VM12345 
System and version (and alternate) S/DK A/XX 
Numeric portion of APAR number 12345 
Possible update file types $12345DK 

| A12345XX 


2. VMFBDNUC creates a list of update files by file name and file type. For example: 


listfile * S12345DK * 
MODABC $12345DK 
MODXYZ $12345DK 
listfile * A12345xXX * 
MODDEF A12345xXX 


3. VMFBDNUC locates MODABC, MODXYZ and MODDEF in the temporary load list and obtains the 
file type (PTF level) of the text deck included in the nucleus build. 


4. VMFBDNUC searches the self-documenting prolog of the text deck to be sure that the APAR number 
(in this example, 12345) is included. If not, a message is put in the build exception log. 


After requisite checking has completed, VMFBDNUC calls the SVMFPATS EXEC with the new load list 
containing file names and file types of text to be loaded. S5VMFPATS$ looks for patches that need to be 
applied to text decks in the load list. Any patches found are inserted into the appropriate text deck and 
included in the IPL deck produced by the loader. 


When the loader has completed punching the text decks, control returns to VMFBLD. 
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VMFBDCPY EXEC: VMFBDCPY will be used to copy the PTF-numbered TEXT deck to the BUILD disk 
identified in the PPF. VMFBDCPY calls VMFLDS to create a new (temporary) load list named $$$TLLS$ 
EXEC, which contains both the file names and file types of text decks to load. Requisite checking is 
performed as in VMFBDNUC. VMFBDCPY then invokes the COPYFILE command to copy the 
PTF-numbered deck to the BUILD disk and to rename it. These files must reside on the BUILD disk with a 
file type of TEXT. 


Return Codes 


VMFBLD issues the following return codes: 


[a Thee as aya erin the command, 


The required file was not found. 
An unrecoverable error was encountered. 
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VMFHASM EXEC 


The VMFHASM EXEC updates a specified source file according to entries in a control file, and assembles 
the updated source file. VMFHASM invokes the CMS UPDATE command, then assembles the updated 
source file using Assembler H Version 2. If you wish, VMFHASM can use the product parameter file to 
establish the minidisk search order. 


Format 


The format of the VMFHASM EXEC is: 


VMFHASM ii ctlfile 
prodid [compname] 


} [ (options ... [)]] 


options: 
SETUP DISK TERM LIST 
NOSETUP PRINT NOTERM NOLIST 


CTL] [DECK RENT 
ieee | onnek | cease [EXP] [XREF] 


where: 


jn 
is the file name of the source file to be updated. It must have a file type of ASSEMBLE. 


ctlfile 
is the file name of the control file The control file must have a file type of CNTRL. If a product 
parameter file exists with a file name of prodid, the name of the CNTRL file will be found in the product 
parameter file under “Compname.” You do not have to specify the ctlfile parameter. 

prodid 
is the product identifier. The prodid for VM/XA System Product Release 2 is 56643082. 

compname 


is the component name specified in the product parameter file. The names for the VM/XA System 
Product Release 2 components are CP, CMS, GCS, and DV. 


options 


SETUP | 
specifies that a new minidisk access order will be set up. 


_ NOSETUP 
specifies that a new minidisk access order will not be set up. You must set the correct access order 
up yourself. 


DISK 
places the listing file on a virtual disk. 


PRINT 
writes the listing file to the printer. 


TERM 
writes the diagnostic information on your display. The diagnostic information consists of the 
diagnosed statement followed by the error message issued. 
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NOTERM 
suppresses the TERM option. 


= produces an assembler listing. 


NOLIST 
does not produce an assembler listing. 


CTL 
indicates that the second parameter is a control file name. 


PPF 
indicates that the second parameter is a product parameter file name. If neither CTL nor PPF is 
specified, the VMFHASM EXEC searches for a file whose name is the same as the second 
parameter. If such a file is found, its file type determines whether it is a control file or a product 
parameter file. If both exist, the product parameter file is used. 


DECK 
creates an object module. 


( NODECK 
suppresses the DECK option. 


RENT 
checks the program for a possible violation of program reenterability. An error message identifies 
code that makes the program nonreenterable. 


NORENT 
suppresses the RENT option. 


| EXP 
( | prints all macro expansions. By default, macro expansions are not printed. 


XREF 
causes the XREF(FULL) option to be invoked when VMFHASM invokes the assembler. The 
default for VMFHASM is XREF(SHORT). 


How VMFHASM Works 


The steps taken by the VMFHASM EXEC are summarized below: 


( 1. If a product parameter file is used, VMFHASM calls VMFOVER to create a copy of the appropriate 
~ component section of the product parameter file with overrides. This copy is used instead of the original 
product parameter file. 


VMFHASM then invokes VMFSETUP (unless you specified NOSETUP) to save your current disk 
access order and build a new disk access order based on the product parameter file. 


2. The VMFHASM EXEC calls the UPDATE command, which includes the CTL, STK, and PRINT 
options. 


UPDATE uses the control file (ctlfile CNTRL) to update the assembler language source file. The new 
file is named $fn ASSEMBLE. 


UPDATE stacks information from the control file in the console stack, and prints the update log file. 


3. Using the library list from the MACS record in the control file, VMFHASM issues a GLOBAL 
MACLIB command. 


4. The updated source file, $fn ASSEMBLE, is assembled using the options indicated on the VMFHASM 
command line. 
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5. The output text deck from the assembly, $fn TEXT, is concatenated with the UPDATES file so that the 
text deck contains a history of update activity. 


6. UPDATE stacks the identifier of the most recent update it found and applied. (If no updates were = 
found, UPDATE stacks the identifier of the MACS record in the main control file instead.) If no PTF ~ 
number or local tracking number is available, VMFHASM uses this update level identifier to determine 
how to rename $fn TEXT. 


If a product parameter file was specified (or used by default), and if the update was listed in an auxiliary 
control file containing the PTF number or local tracking number, the text deck is renamed fn xxxnnnnn, 
where xxx is the text file type prefix from the corresponding record in the main control file and mnnnn is 
the PTF number or local tracking number. The default text file type prefix 1s TXT. 


If a control file was specified (or used by default); or if the PTF number or local tracking number is not 
available, and if the update level identifier is TEXT, the text deck is renamed fn TEXT. If the update | 
level identifier is anything other than TEXT, the text deck is renamed fn TXTxxxxx (where xxxxx is the 
l- to 5-character update level identifier). 


7. Temporary files ($fn ASSEMBLE and fn UPDATES) are erased. 


The input and output files used by VMFHASM are summarized below: 


Input and Output Files 


Disk Input Files 

fn ASSEMBLE Assembler language source 
Jn CNTRL Control file 

Jn MACLIB Macro library 

fn AUXxxxxx Auxiliary control files | : 
fn UPDTxxxx Update files ed 
Jn S$PPF Product parameter file 

Disk Output Files 

fn {TEXT|TXT xxxxx} Object deck, named according to the update level identifier in the control file 

This file also contains data from the UPDATES file, together with date and time information. It is placed on 

the A-disk, which you must access in read/write mode before issuing VMFHASM. 

Printer Output Files ee 
$fn LISTING — Assembler listing Gf PRINT option is in effect) 


This file also contains data from the update log file (fn UPDLOG), describing the updates applied to the 
source file. | 


Messages 


The UPDATE command issues messages to indicate when each update file is applied. 


ASMBLING fn 


Explanation: The assembly is going to begin. If you specified any assembler option on the VMFHASM 
command line, the options used are also displayed. 
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fn {TEXT |TXTxxxxx} CREATED 


Explanation: This message indicates the file name and file type of the text deck. 


Note: If the source is on some other R/W minidisk instead of the A minidisk, VMFHASM won't create a 
text deck identifying the update level on the A minidisk. 
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The VMFMAC EXEC updates macro libraries. It invokes the CMS UPDATE command to update specified 
copy! or macro files, according to entries in a control file, and then builds a new macro library from the 
resulting new versions of those files. 


Format 


VMFMAC libname ctlfile 


where: 
libname - 
is the file name of the macro library to be updated, and of the EXEC file that contains the names of the - 
library members. The entries in /ibname EXEC must be in the following format: * 
&1 &2 fnl 
&1 &2 fn2 


where fnl, fn2, and so on, are file names of macro or copy files to be updated and included in the macro 
library, which must have a file type of MACLIB. 


ctlfile c™ 
is the file name of a control file to be used to apply the updates. The file type must be CNTRL. Ne 


How VMFMAC Works 


1. VMFMAC locates Jibname EXEC and the control file. It also erases any existing files named NEWMAC 
MACLIB and NEWMAC COPY. Then VMFMAC begins reading the macro or copy file names from 
the EXEC, beginning at the bottom. 


2. For each entry in the libname EXEC, VMFMAC: 


¢ Invokes the UPDATE command with its CTL option to apply the updates specified in the control ae 


¢ Adds the updated macro or copy file ($file name MACRO or $filename COPY) to the macro library 
NEWMAC MACLIB 


e Adds the UPDATES file created by the UPDATE command to the file NEWMAC COPY 
e Erases $filename MACRO or $file name COPY, and file name UPDATES. 


3. If there are no update files corresponding to a macro or copy file entry specified in Jibname EXEC, the 
macro or copy file is added to NEWMAC MACLIB in its current form. NEWMAC COPY, containing 
a history of updates applied by VMFMAC, is added to NEWMAC MACLIB. 


1 Copy files are collections of assembler statements that many modules use in common. In source listings, the 
assembler includes copy files by a “COPY copyfilename” statement. They are similar to macro definitions because 
they reside in libraries, but they contain no substitution data. VM/XA System Product uses copy files to define 
control block DSECTS, data areas, and tables. 
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4. If no errors occur during the procedure, then when all the macros have been added to NEWMAC 
MACLIB, NEWMAC MACLIB is renamed /ibname MACLIB. Then, libname MACLIB, if it exists, is 
erased. 


If errors occur during the VMFMAC EXEC procedure (for example, if a MACRO or a COPY file is not 
found) libname MACLIB is not erased, and the updated macro library retains the name NEWMAC 
MACLIB. 


Input and Output Files 


Disk Input Files 


libname EXEC List of macro or copy files to be updated and/or included in libname 
MACLIB. 


ctlfile CNTRL Control file used by the UPDATE command. 


fn MACRO Files to be updated and/or included in the macro library. 
fu COPY 


auxiliary control files : 


Disk Output Files 


libname MACLIB Updated macro library. 
libname COPY Contains the UPDATE files produced by UPDATE command processing. 


Printer Output Files 


The printer is spooled with the CONT option, so that when VMFMAC completes, the printer file contains: 
¢ A copy of the control files | 
e The update log file for each updated macro or copy file the UPDATE command produced 
¢ A copy of each macro or copy file in the macro library 
¢ The libname COPY file, which contains the accumulated UPDATES files the UPDATE command 
created. 
Notes: 


1. When VMFMAC adds files with MACRO file types to a MACLIB, the EXEC takes the membername 
from the macro prototype statement. When VMFMAC adds files with COPY file types to a MACLIB, 
the EXEC follows these rules: | 


a. If the membername is from the COPY file and updates were found, the membername is $filename. 

b. If the membername is from the COPY file and no updates were found, the membername is filename. 

c. If you include a *COPY statement as the first record in the file, the membername is that designated 
on the *COPY statement. The format of the *COPY statement is: 


*COPY membername 


2. If errors occur during VMFMAC processing, consult the NEWMAC COPY file printed by VMFMAC. 
If you can correct the errors involving one or two macro or copy files, you can use the MACLIB 
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command to add these members to NEWMAC MACLIB. Then erase the current /ibname MACLIB and 
rename NEWMAC MACLIB libname MACLIB. | 


Messages 


The UPDATE command issues the message DMSUPDI178I to inform you of the updates being applied to 
each macro or copy file. If no updates are found, message DMSUPD181E 1s issued. 


fn {COPY|MACRO} ADDED 


Explanation: The specified macro or copy file has been added to the macro library. 


libname COPY ADDED 


Explanation: Jibname COPY, containing the update history of the MACLIB, has been added to the macro 
library. 
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VMFLKED EXEC 


The VMFLKED EXEC procedure invokes the CMS LKED command to link-edit modules into a 
LOADLIB. VMFLKED uses the normal CMS search order when searching for TEXT files. 


Format 


The format of the VMFLKED EXEC is: 


VMFLKED | fn | ft im | [ (options... [)] ] 


LKEDCTRL 


* 


where: 


fn 


is the file name of the input control file. You must specify a file name. 


ft 
is the file type of the input control file. The default file type is LKEDCTRL. 


fm 


is the file mode of the input control file. The default file mode is *. 


PRINT 
prints out a hardcopy of the linkage-editor output. 


MODULE module_name 
indicates that only those members of the LOADLIB that include module_name are to be link-edited. 


How VMFLKED Works 


VMFLKED reads the specified LKEDCTRL file and expects to find option records (if any are needed) 
followed by linkage-editor input records. Multiple groups of options followed by linkage-editor input can be 
combined in a single LKEDCTRL file (see Figure 50 on page 694). 


1. VMFLKED processes the option records, which are identified by a percent sign (%) in column one. 


2. VMFLKED processes linkage-editor input records when it finds a nonoption and noncommentary 
record. 


When VMFLKED finds: 


¢ An INCLUDE record, then the process adds the record to the linkage-editor input file and issues a 
FILEDEF for the TEXT file | 


e A NAME record, then the process adds the record to the linkage-editor input file and invokes the 
linkage editor 


e A commentary record (beginning with *), then the process ignores the record 
e Any other record, then the process adds the record to the linkage-editor input file. 


3. VMFLKED continues with Step 1 to process the next group of option records (if any). 
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Input and Output Files 


Input Files 


fn TEXT 


fn LKEDCTRL 


The name of the TEXT file. When the process finds an INCLUDE statement in the 


linkage-editor input control file, it issues a FILEDEF for that TEXT file. The 
linkage editor reads this TEXT file. 


A modified linkage-editor file. INCLUDE cards include TEXT files, and you 
cannot use them to include files from a library. Any record containing an asterisk 


(*) in column one is commentary and the process ignores it. 


The VMFLKED EXEC also recognizes special control (option) records 1n the 
linkage-editor control file (see Table 19). These records, which must begin with a 
percent sign (%) in column one, may only be located between linkage-editor input 
files (that is, groups of them may be at the beginning of the file or following a 


NAME record). 


Table 19 (Page 1 of 2). | Table 19 (Page 1 of 2). Linkage-Editor Control File Special Control (Option) Records Editor Control File Special Control (Option) | Table 19 (Page 1 of 2). Linkage-Editor Control File Special Control (Option) Records 


*%*%CONTROL control _file_name 


% NOCONTROL This record indicates not to take the file type for 
linkage-editor input files from a control file. 


% LIBRARY load_library_name 
%LEPARMS link-edit parameters 


%MAXRC maximum _valid_return_code 
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This record indicates to take the file types for 
linkage-editor input files from a control file. The 
name of the control file is specified on the 

% CONTROL record and the file type is CNTRL. 
When the %CONTROL record is read, 
VMFLKED reads the control file and uses the 
first “word” of each line of the file to build an 
array of file types. The first line of the file 
indicates the default file type. Each of the file 
types is checked and if it is not TEXT, then the 
characters TXT are put at the beginning. When 
an VMFLKED finds an INCLUDE card, it 
searches the array. VMFLKED uses the first file 
type from the array that matches an existing file. 


This option is in effect until a %“~NOCONTROL 
record is found. 


This record changes the LOADLIB to be used and 
the name on the LKEDIT listing. The default for 
the LOADLIB name is the file name of the 
LKEDCTRL file. 


This record sets the link-edit parameters used in 
each link-edit step. If no parameters are specified, 
then none are used. 


This record sets the maximum valid return code. 
The VMFLKED EXEC checks this value when it 


_ ends. If the highest return code is higher than this 


value and is not listed on the %*ACCEPTRC 
record, then the EXEC issues a warning message. 


VMFLKED 


Table 19 (Page 2 of 2). Linkage-Editor Control File Special Control (Option) Records 


C 


%~ACCEPTRC return code(s) This record lists the acceptable return code(s) for 


VMFLKED processing. (The return code(s) are 
usually higher than entry on the %“MAXRC 
_ a 
— | 


link-edit. If the return code(s) after any link-edit 
is higher than the %MAXRC record and not 
specified on the $ACCEPTRC record, then 
VMFLKED issues a warning message at the end 
of its processing. 


This record causes the EXEC to bypass the 
warning message for missing TEXT files. Once 
specified, this record takes effect for all subsequent 
link-edits (or until a % NOIGNORE record is 
found). 


This record causes a warning message to be issued 
if there is a missing TEXT file. Once specified, 

this record takes effect for all subsequent link-edits 
(or until a %IGNORE record is found). 


This record erases LOADLIB and LKEDIT files. 
This is useful when you rebuild the LOADLIB as 
it keeps the LOADLIB and LKEDIT files as small 


entry). VMFLKED checks the value(s) after each 
“ERASE 


as possible. If this record is not specified, then the 
LOADLIB and LKEDIT files are not erased. 


Note: The %ERASE control statement takes effect immediately, and erases whatever is the current 
LOADLIB. The LOADLIB is not erased if you use the MODULE option. (The LOADLIB can be 
changed using the % LIBRARY control statement). 


Output Files 

fn LOADLIB The main output from the linkage editor. This file contains the link-edited load 
( . modules. 

fn LKEDIT The file that contains the linkage-editor map for all modules. 


The following is an example of a LKEDCTRL file. 
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%CONTROL YOURCTRL 


%LIBRARY NCCF 
%ERASE 

%MAXRC 4 
%ACCEPTRC 12 14 


%LEPARMS NCAL LIST XREF LET RENT 
INCLUDE DSIZDST 
INCLUDE DSIZSHP 
INCLUDE DSILUTRM 
ORDER DSIZDST 
ENTRY DSIZDST 
NAME DSIZDST(R) 
%LEPARMS NCAL LIST XREF LET REUS 
INCLUDE DSIVMCMD 
INCLUDE DSIVMMSG 
ORDER DS IVMCMD 
ENTRY DS IVMCMD 
NAME DSIVMCMD(R) 


% IGNORE 


%LEPARMS NCAL LIST XREF LET RENT 
INCLUDE DSIPRTVM 
ENTRY DSIPRTVM 
NAME DSIPRTVM(R) 


Figure 50. Example of a LKEDCTRL file 


Messages 


DMSWLKO002E 
DMSWLK002W 
DMSWLK003E 
DMSWLKOOSE 
DMSWLKO10E 
DMSWLKO65E 
DMSWLK842E 
DMSWLK8431 
DMSWLK844E 
DMSWLK845W 


DMSWLK846I 


File fn ft [fm] not found 

File fn ft not found 

Invalid option opt 

No {LKEDCTRL|MODULE} specified 
Premature EOF on file fn ft 
{PRINT|MODULE} option specified twice 

No {control|library} file name found in fn ft [fm] 
An invalid control record was found and ignored: 
No linkedit performed 

Errors were encountered during the link edit processing that will probably make the loadlib 
unusable 

LKED target_module into library 


For a complete explanation of each message, refer to VM/XA SP System Messages and Codes Reference. 
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VMFMERGE EXEC 


The VMFMERGE EXEC procedure applies PTFs (program temporary fixes) from the DELTA disk to the 
MERGE disk. 


Do not use this procedure to service any of the base components of VM/XA SP. Use this procedure when 
applying PTFs to System Network Architecture (SNA) products. 


VMFMERGE requires a service control file (ptjnum SCF) for each requested PTF and its requisites. The 
service control file contains instructions for applying the PTF. To use VMFMERGE, you must access the 


minidisk containing the prodid VMFPARM file. This file identifies the minidisks that VMFMERGE must 
access to service each product. 


Format 


The format of the VMFMERGE command is: 


VMFMERGE|  prodid = PTF {ptfnum |* } [EXCLUDE exclist | 


PTFLIST applist 


where: 


prodid 
is the ID of the product you specify. 


You cannot specify a prodid of EXCLUDE, because EXCLUDE is a keyword for this EXEC. 
PTF a mum 


applies a single PTF if you specify a PTF file name (pt/num). If you enter an asterisk (*) instead of a 
PTF file name, you will apply all PTFs for the product, as listed in the apply list, called prodid 
APPLIST, supplied on the service tape. You cannot specify a file name of EXCLUDE, because 
EXCLUDE is a keyword for this EXEC. 


If the service tape contains an exclude list file named prodid EXCLIST, any PTF listed in that file is not 
applied. 


PTFLIST appiist : 
applies the selected PTFs listed in the apply list file, applist APPLIST. If you specify a file name of 
EXCLUDE, you cannot use the EXCLUDE option to specify an Exclude List. 


If the service tape contains an exclude list file named prodid EXCLIST, any PTF listed in that file is not 
applied. 


EXCLUDE exciist 
excludes the selected PTFs listed in the exclude list file, exclist EXCLIST. PTFs listed in prodid 
EXCLIST are excluded, in addition to those in the user-specified exclude list. If you specify EXCLUDE 
as the apply list file name, you cannot use the EXCLUDE option to specify an exclude list. 


If you use prodid EXCLIST as the name of your exclude list, then VMFMERGE ignores any other 
prodid EXCLIST file, including the one that may be supplied on the service tape, during processing. You 
should therefore use some other name for the exclude list you create. 


Note: If two PTFs are in the same text deck, you cannot exclude the first unless you also exclude the 
second, even if you list the first one on the exclude list. This restriction applies because the first 
PTF is considered to be a prereqisite for the second PTF. 
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If you list the first PTF in the exclude list, but not the second, and if the second PTF appears in 
the apply list, both PTFs will be applied. You will receive an error message indicating that a PTF 
you wanted to exclude has been applied. 


How VMFMERGE Works 


VMFMERGE is a service process that processes PTFs. The EXEC procedure: 


1. Uses the parameter file (prodid VMFPARM) to determine the virtual address of the merge and delta 
disks. 


2. Checks the merge log to insure that the PTF you select is not already merged or superseded. 


| 3. Reads the service control file to get the prerequisite and corequisite PTFs and the elements affected by 
x this PTF. | 


e If the service control file for any of the prerequisite or corequisite PTFs is missing, then processing 
for the current PTF stops. 


e Ifa prerequisite or corequisite PTF is in the exclude list, then the current PTF is not merged. | a 


e Ifa prerequisite or corequisite PTF has a status of “SUPERSEDED”, then that prerequisite or 
corequisite is not merged. 


e If the requisite is not within this product, the system displays a message indicating that the requisite 
PTF must be merged at some later time. 


¢ When you merge a PTF that is a requisite of a change in another product, be sure to note this 
| requisite information. There is no automatic way to tell you of this cross-product requisite if at a 
later time you remove the change that is a requisite of a change in another product. 


4. Does the necessary COPY/RENAME from the delta disk to the merge disk for each element in the ( 
prerequisite and corequisite chain that was not “SUPERSEDED” or already merged. aad 


Note: Temporary files are created during this COPY/RENAME process to insure system integrity. 
These files are erased during normal VMFMERGE processing. 


5. Adds service history to the element if it is a text deck. Element history consists of text deck comment(s) 
containing: 


¢ The PTF or APAR number 
e A time and date stamp eos 
e Any apartext information that was in the service control file (SCF). bo 


Note: A temporary file ($APARTXT SVMFMERG) ts created during this history process to ensure 
system integrity. VMFMERGE erases this file during normal processing. 


6. Updates the reqby log to reflect all the requisite relationships of all the merged and superseded PTFs. 


7. Marks in the merge log any ZAPs and PTFs that are superseded by this PTF. Those ZAPs and PTFs 
are never applied. 


8. Puts entries in the merge log to show which PTFs have been merged. 


Notes: 


1. You can issue VMFMERGE to process a single PTF, a list of PTFs, or all PTFs on the input disk for a 
product. 


2. Merged PTFs cannot be excluded, but can be superseded. 


3. Superseded PTFs cannot be merged nor excluded. 


4. PTFs in the Exclude List can be superseded. 
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DMSWMG002E 
DMSWMG008E 
DMSWMG017E 
DMSWMGS520E 
DMSWMGS4SE 
DMSWMG649E 
DMSWMG653E 
DMSWMG856E 


DMSWMG857E 
DMSWMG858E 
DMSWMG859E 
DMSWMG860E 
DMSWMG861I 
DMSWMG862I 
DMSWMG863E 
DMSWMG864E 
DMSWMG864I 
DMSWMG864W 
DMSWMG865I 
DMSWMG866W 
DMSWMG867E 
DMSWMG868E 
DMSWMG869E 
DMSWMG870E 
DMSWMG871E 
DMSWMG872E 
DMSWMG873E 


DMSWMG874E 
DMSWMG882W 
DMSWMG883W 
DMSWMG886E 
DMSWMG892E 
DMSWMG893E 
DMSWMG893W 
DMSWMG898E 


VMFMERGE 


File fn ft [fm] not found. 

Device vdevno invalid or nonexistent. 

Invalid device address vdevno. 

Invalid operand: operand. 

Missing operands. 

Extraneous parameter parm. 

Error executing command. 

Disk address vdevno is listed more than once on the DELTA and/or MERGE entry records 
in the prodid VMFPARM file. 

The number of disk addresses on the DELTA entry record cannot exceed nine. 

Unable to find a tag entry record in the /7 /t file. 

The prodid VMFPARM file has no disk addresses on the {MERGE|DELTA} entry record. 
Only one {MERGE|DELTA} entry record may appear in the prodid VMFPARM file. 
Accessing disk_type disk vdevno as fm. 

Change name has been action. 

The MERGE disk vdevno must be linked read-write. 

PTF name will not be action because it already is status. 

PTF name will not be action because it already is status. 

PTF name will not be action because it already is status. 

Processing PTF name. 

No PTFs have been action. ° 

Invalid status status in prodid VMFMGLOG for entry pif. 

PTF name is not a part of product prodid. 

Error in file fn ft fm. data is invalid for tag tag. 

Error in file fn ft fm. There are no elements. 

Error in file fn ft fm. The name tag is missing. 

Error in file fn ft fm. REPLACE tag missing after the element name. 

Error in file fn ft fm. parm is an invalid parameter. Expecting parameter(s) PRODID, 
PREREQ, COREQ, SUP, APARTEXT, or CHANGES. 

Invalid entry found at line /ine in fn ft. 

File fn ft [fm] [from name] not found on any DELTA disks from the VMFPARM file. 
PTF name is not a part of product prodid and must be action in product prodid. 

File name name from the fn ft [fm] file is longer than 8 characters. 

PTF name has not been action. 

Incomplete processing, not all [required | PTFs were action. 

Incomplete processing, not all [required | PTFs were action. 

VMFREMOYV processing is incomplete. 


For a complete explanation of each message, refer to VM/XA SP System Messages and Codes Reference. 
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VMFNLS EXEC 


The VMFNLS EXEC procedure updates national language-related files. VMFNLS automatically applies 
updates to source files, generates text files, and renames them so they can be loaded into the system. If you 
have your own language files, this EXEC is provided so that you can maintain those files. 


Format 


MMS | mn fone Comemanes opm 


options: 


PPF SETUP 
CTL NOSETUP 
where: 
fn 
is the file name of the source file that is to be converted to text. 
ft 
is the file type of the source file that is to be converted to text. Only ASSEMBLE, REPOS, and DLCS 
file types are allowed. 
ppfname 
is the file name of either the base product parameter file (which is the product identification number, 
prodid) or a product parameter override file containing an override area for the component. The file type 
must be $PPF. 
compname 


is the name of either a base component area (which is a base component name, such as CP or CMS) or a 
component override area containing alternative and/or additional parameters for the component. If you 
do not specify a valid name, VMFNLS shows you a list of names and asks you to enter one. 


ctlfile 
is the file name of the control file that is used to apply updates to the source file before text is generated. 
The file type must be CNTRL. The IBM-supplied control files are described in Chapter 7, “How 
VM/XA System Product Uses Control Files and Update Files” on page 377. 


options 


PPF 
indicates that the third operand in the command is the name of a product parameter file or override 
file that specifies the minidisk/directory search order and the name of the control file. 


CTL 
indicates that the third operand in the command is the name of a control file. If CTL is specified, 
the product parameter file is not used. 


If neither CTL nor PPF is specified, VMFNLS searches for a file whose name matches the third 
operand in the command. Ifa file with that name is located, VMFNLS checks the file type to 
determine if the file is product parameter file (SPPF) or a control file (CNTRL). If both files exist, 
the product parameter file is used. 
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SETUP 
sets up a minidisk/directory access order for the assemble function. This option is valid only when 
using a product parameter file. 


NOSETUP 
does not set up a new access order. 


Note: In addition to the options described above, VMFNLS accepts certain options for three of the 
commands that it issues: 


e ASSEMBLE 
¢ GENMSG 
¢ CONVERT COMMANDS. 


Some options are assigned by VMFNLS; other options that can be used depend on the file 
type of the source file. See the following section, “How VMFNLS Works.” For complete 
descriptions of these commands and their options, see VM/XA SP CMS Command Reference. 


How VMFNLS Works 
( 1. If a product parameter file is being used: 


a. VMFNLS calls the VMFOVER EXEC to build a temporary product parameter file (file type 
$PPFTEMP) containing the parameters for the component being processed. 


b. If a user EXEC is specified in the USEREXIT tag in the $PPFTEMP file, VMFNLS calls the user 
EXEC with the parameters VMFNLS and SET-UP. 


c. If the NOSETUP option is not specified, VMFNLS calls the VMFSETUP EXEC with the ACCESS 
ASM options to save the current minidisk/directory access order and build a new one for the 
( 7 assemble function using data from the $PPFTEMP file. 


2. VMENLS issues the UPDATE command with the CTL, STK, PRINT, and OUTMODE AI options. 


UPDATE uses the control file (ctlfile CNTRL) specified in the product parameter file or in the 
VMENLS command to update the assembler language source file. 


UPDATE stacks information from the control file in the console stack and prints the update log file. 


The OUTMODE AI option specifies that the files created by the UPDATE command are written on file 
mode A with a file mode number of | (Al). 


Ifa PTF file is missing, UPDATE writes a message to the console and to the update log file. 


3. At this point, processing depends on the file type of the input source file: 
e If the source file is an ASSEMBLE file: 


a. Using the library list from the MACS record(s) in the control file, VWMFNLS issues a GLOBAL 
MACLIB command. 


b. VMFNLS issues the ASSEMBLE command to assemble the updated source file. 
e If the source file is a REPOS (message repository) file: 
a. VMFNLS determines the /angid associated with the source file: 


~— If the source file name is only six characters, VMFNLS assigns AMENG (American English) 
as the default langid. 


— If the source file name is longer than six characters, VMFNLS extracts the country code 
from the seventh and eighth characters of the file name and searches the VMFNLS 
LANGLIST file to find the corresponding Jangid. This file contains a list of all valid country 
codes, along with the associated /angids and language names, as shown in Figure 51 on 
page 700. 
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American English 
Kanji 
Uppercase English 


Brazilian Portuguese 
French 
German 


Figure 51. VMFNLS LANGLIST File 


700 


If the country code from the source file name is not contained in the VMFNLS LANGLIST 
file, then all temporary files are erased, the printer is closed, and VMFNLS terminates. 


b. VMFNLS issues the GENMSG command to compile the input REPOS file and produce a text 
file. VMFNLS sets up the operands for GENMSG as follows: 


fn | 
is the file name of the file to be compiled. GENMSG places this name in the ESD card 
when the text file is produced. The possible file names are: 


fn Repository 
HCPMES CP 
DMSMES CMS 
CSIMES GCS 
ft 
is REPOS, the file type of the repository file to be compiled. 
applid 
corresponds to the first three characters of the file name of the source file: 
applid Application 
HCP CP 
DMS CMS 
CSI GCS 
langid 
is the language identifier of the source file. 
options 


depend on the component associated with the source file. For the CP repository, VMFNLS 
uses the GENMSG options CP MARGIN 63. For other components, VMFNLS uses the 
GENMSG option MARGIN 63. 


Note: For a Kanji CP repository, VMFNLS uses the GENMSG options CP DBCS. For 
other Kanji repositories, VMFNLS uses the GENMSG option DBCS. 


Other GENMSG options can be specified with the VMFNLS command if they do not 
conflict with the GENMSG options assigned by VMFNLS. 


GENMSG produces a text file that has the same file name as the input file and a file type of 
TEXT. GENMSG also produces a LISTING file, whose file name is the source file’s file name 
with a prefixed dollar sign. | 
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The following table shows some examples of the text and listing files written to file mode A from 
a given message repository source file: 


Source File Text File Listing File 

HCPMES REPOS HCPMES {TEXT|TXTnnnnn} $HCPMES LISTING 
DMSMESA REPOS DMSMESA {TEXT|TXTrannn} S$DMSMESA LISTING 
CSIMESB REPOS CSIMESB {TEXT|TXTxnannn} $CSIMESB LISTING 


Note: mnnnn is the number of the most recently applied PTF. 


The updated source file is then printed. 


For a complete description of the GENMSG command, see VM/XA SP CMS Command 
Reference. 


e If the source file is a DLCS (definition language for command syntax) file, VMFNLS issues the 
CONVERT COMMANDS command to produce two text files from the input file. 


( VMENLS sets up the operands for CONVERT COMMANDS as follows: 
in 
is the file name of the file to be compiled. 
ft 
is the file type of the file to be compiled. 
fm 
is always set to *. 
( az options 
L are not assigned by VMFNLS; any valid CONVERT COMMANDS options can be specified. 


The file names of the text decks produced by CONVERT COMMANDS depend on the DLCS 
statement contained in the input file. This statement identifies the applid, langid, and whether the 
input file is a user or system DLCS file. CONVERT COMMANDS uses the /angid to obtain the 
corresponding country code (y) from the VMFNLS LANGLIST file. 


For a system DLCS file, the file names of the text decks are applid SPAy for the command syntax 
definition file and applid SSYy for the translation and synonym table. For a user DLCS file, the file 
a names of the text decks are applid UPAy for the command syntax definition file and applid USYy for 
( | the translation and synonym table. 


The file type of the output text files is TEXT. 


The following table shows some examples of the text files produced from a given source file: 


Source File Text Files 
DMSSPA DLCS DMSSPA TEXT 
DMSSSY TEXT 
DMSSPAB DLCS DMSSPAB TEXT 
DMSSSYB TEXT 
DMSSPAC DLSC DMSSPAC TEXT 


DMSSSYC TEXT 
The updated source file is then printed. 


For a complete description of the CONVERT COMMANDS command, see the VM/XA SP CMS 
Command Reference. 
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4. Each output TEXT file from the ASSEMBLE, GENMSG, or CONVERT COMMANDS processing is 
concatenated with the UPDATES file so that the TEXT file contains a history of update activity. 


5. VMFNLS renames the TEXT file as follows: 


¢ If the PPF option is specified and no PTF prefix is found in the control file, the TEXT file is 
renamed fn TXTnnnnn, where nnnnn is the PTF number obtained from last AUX file entry processed 
by the UPDATE command. If a PTF prefix is found in the control file, that prefix overrides the 
TXT default. 


e If the CTL option is used, VMFNLS uses the update level identifier from the control file (the 
identifier of the most recent update that was found and applied is stacked by the UPDATE 
command), to rename the TEXT file. If the update level identifier is anything other than TEXT, the 
TEXT file is renamed fn TXTnnnnn (where nnnnn is the 1- to 5-character update level identifier). 


The new fn TXTnannn or fn T EXT file is found on file mode A. 


Note: The new text deck will be file mode Al regardless of the file mode of the original text deck. If the 
file mode number of the original text deck is anything other than 1, you must rename the text 
deck created by VMFNLS. ra 


6. If a product parameter file is being used: 
a. VMFNLS calls VMFSETUP to restore the original minidisk/directory access order. 


b. If a user EXEC is specified in the USEREXIT tag in the $PPFTEMP file, VMFNLS calls the user 
EXEC with the parameters VMFNLS, CLEAN-UP, and a return code. 


Messages 

DMSWNLOOLE No file name specified. an 

DMSWNLO002E VMFNLS LANGLIST * not found. C a 

DMSWNLO023E No file type specified. 

DMSWNLO032E Invalid file type ft. 

DMSWNL122E Return code rc from routine. 

DMSWNLI79E Missing or invalid MACS card in control file fn ft fm. 

DMSWNL328E Control file not specified. 

DMSWNL448E Country code code not in Jist. 

For a complete explanation of each message, see VM/XA SP System Messages and Codes Reference. 
Ao 
( 
a er 
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VMFOVER EXEC 


The VMFOVER EXEC makes a temporary copy of one component section from the product parameter file 
with changes made in accordance with the override section of the product parameter file or a separate PPF 


override file. The other service and installation EXECs use this copy instead of the base product parameter 


file. 


VMFREC, VMFAPPLY, VMFHASM, and VMFBLD all issue VMFOVER automatically. You can also 
issue VMFOVER from the command line if you want to see the temporary product parameter file. 


Format 


The format of the VMFOVER EXEC 1s: 


VMFOVER | prodid compname 


where: 


prodid 
is the product identifier of the product to be serviced. For VM/XA System Product Release 2, the 
product identifier is 56643082. 


compname 
is the component to be serviced, for example, CP or CMS. compname can be a name listed after the 
;>COMPLST. tag or the :OVERLST. tag in the base PPF; or after the :OVERLST. tag in the PPF 
override file. If you do not specify the compname, you will be shown a list of components and asked to 
choose one. 


How VMFOVER Works 


VMFOVER locates the file with a file name of prodid and a file type of $PPF. This file can be either a base 
PPF or a PPF override file. The EXEC then checks the list of component names following the :COMPLST. 
tag for the component name you specified. If the name is found, this is the base product parameter file. The 
appropriate component section is copied to a file called prodid $PPFTEMP, and processing stops. 


If the component name is not listed after the :;COMPLST. tag, VMFOVER looks for it after the :OVERLST. 
tag. If the component name is not listed there, VMFOVER issues an error message. 


If the component name is found after the :OVERLST. tag, VMFOVER looks for a :compname. tag. The 
:compname. tag tells VMFOVER where to look for the basic information about the component. For 
example: 


sCP. CP 56643082 


:CORCP. CP 


The first example is from an override file. It tells VMFOVER that the basic information about CP is found 
in the CP section of 56643082 $PPF. The second example is from the override section of a base PPF. Notice 
that it does not specify a file name. It tells VMFOVER to look for the base information about CORCP in 
the CP section of this file. 
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Override information follows the :compname. tag. VMFOVER combines the override information with the 
base information to create a copy of the appropriate component section of the product parameter file. The 
file name of the copy is the file name of the override file if the NEWNAME option was specified on the 
:compname. tag in the override file; otherwise, it is the file name of the base PPF. The file type of the copy is 
$PPFTEMP. | 


For examples of a base product parameter file with an override section, an override file, and $PPFTEMP 
files, see Chapter 8, “Files Used in Program Update Service and Corrective Service.” | 
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VMFPLC2 Command 


The VMFPLC2 command loads source code files from the Product Tape and loads the service installation 
EXEC (VMSERV) from the program update tape. VMFPLC2 also dumps CMS files from disk to tape, 
loads previously dumped files from tape to disk, and performs various control operations on a specified tape 
drive. Disk files to be dumped can contain either fixed-length or variable-length records. 


The VMFPLC2 command does not process multivolume files. Files processed by the VMFPLC2 command 
must be in a unique CMS format. 


Format 
VMFPLC2 (optionA optionB 
optionD ) 
(optionB optionC 
( optionD optionE ) 
(optionB optionC 
optionD optionF ) 
(optionB optionC 
optionD ) 
MODESET | @ptionD ) | 
( - tapcmd | (optionD ) | 


optionA: 


option B: 


optionC: 


optionD: 


optionE: [SELect|] [STOP] 


optionF: | DATE | 
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where: 


poe feyei 


dumps one or more disk files to tape. If fn or ft is specified as an asterisk (*), all files that satisfy the 
other file identifier are dumped. 


If fm is coded as a letter, that disk and its extensions are searched for the specified file(s). If fm is coded 
as a letter and number, only files with that mode number and letter (and the extensions of the disk 
referenced by that fm letter) are dumped. If fm is coded as an asterisk (*), all accessed disks are searched 
for the specified file(s). If fm is not specified, only the A-disk and its extensions are searched. | 


oo {C0 


reads CMS files onto disk. The optionC options control the area on the tape that the command searches. 
For instance, if EOF 1 (the default) is in effect, VMFPLC2 loads only the file(s) specified before the first 
physical tape mark. 


If a file identifier is specified, only that one file is loaded. If an asterisk (*) is specified for fn or ft, 
VMFPLC2 loads all files that satisfy the other file identifier. 


The files are written to the disk indicated by the file mode letter. The file mode number, if entered, 
indicates that only files that have that file mode number are to be loaded. 


SCAN 4 ft 


lists the identifiers of the files it scans. The optionC options control the area on the tape that the 
command searches. For instance, if EOF 1 (the default) is in effect, VMFPLC2 scans only the file(s) 
specified before the first physical tape mark. However, if a file identifier (fn and ft) is specified, scanning 
stops upon encountering that file; the tape remains positioned ahead of the file. 


SKIP fn\j ft aa 
* * 


lists the identifiers of the files it skips. The optionC options control the area on the tape that the | 

command searches. For instance, if EOF 1 (the default) is in effect, VMFPLC2 skips only the file(s) 

specified before the first physical tape mark. However, if a file identifier (fn and ff) is specified, skipping 
- stops after encountering that file; the tape remains positioned immediately following the file. 


MODESET 
sets the values specified by the DEN, TRACK, and TRTCH options. After initial specification in a 
VMFPLC2 command, these values remain in effect for the virtual tape device until they are changed in a 
subsequent VMFPLC2 command, RDTAPE, WRTAPE, or TAPECTL macro. 


tapemd «| 


specifies a tape control function (tapcmd) to be executed n times (default is 1 if n is not specified). These 
functions also work on tapes in a non-CMS format. 


Tapemd Action 

BSF Backspace n tape marks 

BSR Backspace n tape records 
ERG Erase gap 

FSF Forward-space n tape marks 
FSR Forward-space n tape records 
REW Rewind tape to load point 
RUN Rewind tape and unload 
WTM Write n tape marks 
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WT™M 
writes a tape mark on the tape after each file is dumped. 


NOWTM 
writes a tape mark after each file is dumped, then backspaces over the tape mark so that subsequent files 
written on the tape are not separated by tape marks. 


NOPRINT 
does not spool to the printer the list of files dumped, loaded, scanned, or skipped. 


PRINT | 
spools to the printer the list of files dumped, loaded, scanned, or skipped. 


TERM 
displays a list of files dumped, loaded, scanned, or skipped. 


DISK 
creates a disk file containing the list of files dumped, loaded, scanned, or skipped. The disk file has the 
file identification of TAPE MAP AS. 


APPEND 
causes the disk file (containing the list of files dumped, loaded, scanned, or skipped), to be added to the 
end of an existing TAPE MAP. 


EOT n 
EOF EOF 1 


EOT reads the tape until an end-of-tape indication. EOF n reads the tape through a maximum of n tape 
marks. EOF 1 is the default. 


n 
TAP cuu 
181 
specifies the virtual device address of the tape to be read or written to; cuu is 181, 182, 183, or 184. The 
default is 181. You can also use TAPn, where n is a single digit number. The number is appended to the 
number 18 to form a device number. For instance, TAP! becomes 181 and TAP2 becomes 182. The 


unit specified by cuu must previously have been attached to your CMS virtual machine before any tape 
I/O operation can be attempted. 


DEN den 
is the tape density, where den is 800, 1600, 6250, or 38K. 9TRACK is assumed. In the case of either 
800/1600 or 1600/6250 dual-density drives, 1600 is the default. 


SELECT 
inhibits loading of a file from the tape in cases when VMFPLC2 would replace an identical file on the 
disk. Files will be loaded only if they do not exist on the specified disk, or when the date/time stamp for 
the file on the disk does not match the date/time stamp for the corresponding file on the tape. 


STOP 
assumes that files contained on the tape are in alphabetical sequence. If the requested file is on the tape, 
the file is loaded onto disk and the tape stops. If the file is not on the tape and a file is encountered that 
is alphabetically beyond the bounds of the requested file, the tape stops. You must specify fn ft. Neither 
jn nor ft may be specified as an asterisk (*). | 


DATE 
displays listfile information during a SCAN. The information displayed includes number of records, 
length of records, and date/time stamp. 
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Usage Notes 


1. If conflicting options are specified on the VMFPLC2 command line, the last option entered on the 2 
command line is in effect. 4 


2. The VMFPLC2 command writes tape records 4005 bytes long. The first character is a binary 2 (X'02'), NW 
followed by the characters CMS and a file format byte, followed by 4000 bytes of file data packed © 
without regard for logical record length. If a null block is dumped, the character 0 replaces the byte after 
CMS. This causes subsequent loading of null blocks to be ignored. In the final record, the character N 
replaces the blank after CMS, and the data area contains CMS file directory information. 


3. If a tape file contains more CMS files than would fit on a disk, the tape load operation may terminate if 
there is not enough disk space to hold the files. To prevent this, when you dump the files, separate 
logical files by tape marks, then forward space to the appropriate file. 


4. The CMS file directory is the first record of each CMS file on tape. 


5. It is possible to run a tape off the reel in at least one situation. If you specify EOF n and n is greater 
than the number of tape marks on the tape, the tape will run off the reel. 


6. For more information on tape file handling, see VM/XA SP Real System Operation. 


7. Do not use TAPE as a synonym of VMFPLC2, or vice versa. If you do, do not use these synonyms to | 
call either function from within another EXEC. You may use any other valid synonym, for example, 
TAP. 
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VMFREC EXEC 


Use the VMFREC EXEC to map the program update tape and to receive update files from the PUT tape. 


Format 


The format of the VMFREC EXEC is: 
VMFREC {INFO [(options! [options2]| —} 


compname 


prod roduct exec slated! [(options2 ... [)]] 


LIST fn ft 


options!: MEMOS|EXECS|SDMAP|ALL 


options2: 
PUT LOG SETUP 
COR NOLOG NOSETUP 
where: 
INFO 


creates the service disk map. 


For all options of INFO, the service disk map and other files specified by the option are loaded to file 
mode C if it is accessed, or on file mode A if file mode C does not exist. 


The following options are used with INFO: 
options1: 


MEMOS 
loads the tape descriptor file, the tape document, and product memos. The service EXECs and PPF 
files are not loaded with this option. MEMOS is the default option. 


EXECS 
loads the service EXECs and PPF files from the first and second files on the tape. 


SDMAP 
creates the service disk map and loads the tape descriptor file. 


ALL 
loads the tape descriptor file, the tape documents, product memos, product parameter files and 
SErviCe EXeCs. 


prodid 
is the product identifier of the product to be serviced. For VM/XA System Product Release 2, the 
product identifier is 56643082. 


compname 
is the component listed in the product parameter file to be serviced. The names for the VM/XA System 
Product Release 2 components are CP, CMS, GCS, and DV. 


If you do not specify the compname for a product that has more than one component, you will be shown 
a list of components and asked to choose one. 
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product exec parameters 
are any parameters you want to pass to the product-specific EXEC that VMFREC invokes. 


LIST fx ft 
gives the file name and file type of a file containing a list of product identifiers and, ophonany: product 
EXEC parameters for products you wish to service. 


If any product identified in the list supports the service enhancements, the product parameter file for that 
product must be loaded from the tape for the LIST option to be successful. 


options2: 


PUT 
indicates that you are receiving files from the program update service tape. PUT is the default. 


COR 


indicates that you are receiving files from the corrective service tape. 


LOG 
specifies that error messages will be written both to the receive exception log and, if critical, to the 
terminal. LOG is the default. , 


Notes: 
1. Non-critical messages are written only to the receive exception log, not to the terminal. 


2. Messages issued by the VMFOVER EXEC, which VMFREC invokes, are written only to the 
terminal, not to the receive exception log. 


NOLOG 

specifies that error messages will be written only to the terminal. 
SETUP 

specifies that a new minidisk access order will be set up. SETUP is the default. 
NOSETUP 


specifies that a new minidisk access order will not be set up. 


Note: The SETUP and NOSETUP options are not applicable to VMFREC INFO and its associated 
options. 


Usage Notes 


1. The default for VMFREC INFO is MEMOS, which ignores the EXECs in the first file on the tape and 
the PPFs in the second file on the tape. 


2. You can replace the current level of the service EXECs on your system by using the EXECs option on 
the VMFREC INFO command. The EXECs option loads the service EXECs and product parameter 
files to file mode C if it exists, or to file mode A. 


3. You can set up a separate minidisk for the service EXECs and product parameter files. To do this: 
a. Allocate and format the minidisk. 


b. Specify this minidisk in the TASK statement of your product parameter file as a read-only disk. For 
example: | 


If you always have a disk accessed as the C-disk while receiving service, the A-disk will never have 
service-executable parts on it. Disk address 5ES5 is used in this example. 


work disk a-disk 191 

file 1&2 c-disk 5E5 service parts from tape 

service disk b-disk 5E5 read-only extension of itself during 
apply and build 
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The above access order can be used to access the 5ES disk as file mode C immediately after file mode 
A during VMFREC INFO. This access order works in conjunction with the following override file: 


| 

| 

| :OVERLST. CP 

| :CP. CP. 56643082 
| 
| 
| 


:MDA. 
TASK = 5E5/ * replace existing system card with service 
*% * build disk as an extension of itself (read-only) 


| This allows the A-disk to be used for temporary replacement of service EXECs on the service build 
| disk (the C-disk). 


| c. Change your SETUP EXEC to access only this minidisk. 


| To load the service EXECs and product parameter files to your service minidisk, access your service 
| minidisk as file mode C and enter: 


| VMFREC INFO (EXECS 


| Note: The EXECS option of VMFREC INFO loads any product parameter files from tape file 2 of the tape 
Boe | volume currently mounted. If the service tape is a multi-volume tape, you must run VMFREC INFO (EXECs for 
( | all volumes that contain product parameters file of interest to you. 


| How VMFREC Works 


| The following lists summarize VMFREC processing: Figure 52 on page 717 illustrates VMFREC 
| processing. 
| For VMFREC INFO: 


( | 1. VMFREC creates the tape map on file mode A and copies it to $LEVEL $TAPE file on file mode C (if 
se | it exists), or on file mode A. Then VMFREC maps the 3-character file type abbreviations to their real 
| file types, creates the list of service parts found on the tape, and does service level checking. 


| 2. VMFREC creates or adds to the service diskmap for this volume. 

| The rest of the steps decribe the actions taken by VMFREC for the MEMO, EXECs, SDMAP, and ALL 
| options. 

| © For the MEMO option, VMFREC: 


( | 1. Loads the documentation CMS files from tape files 1 and 2 to file mode C (if it exists) or file mode 
| A. 


| ¢ For the EXECs option, VMFREC: 

| 1. Saves the old service parts and notifies the user for each part saved. 

| 2. Loads the service-related CMS files from tape files 1 and 2. 

| 3. Copies the service files with PTF-numbered file types to files with the same names and real file types. 
| 4. Creates or updates $LEVEL EXEC. 

| ¢ For the SDMAP option: 


| 1. Since the purpose of this option is to create the service disk map, the steps for this option are already 
| done at the beginning of VMFREC processing. 


| © For the ALL option, VMFREC: 
C , | 1. Saves the old service parts and notifies the user for each part saved. 


. Loads all the CMS files from tape files 1 and 2. 


to 


| 3. Copies the service files with PTF-numbered file types to files with the same names and real file types. 
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f 
For all other VMFREC options: (> 
¢ When invoked with a ppfname or a prodid, either directly or through the LIST operand, VMFREC: 
— Creates the tape map on file mode A and copies it to the $LEVEL $TAPE file on file mode C cif it 
exists), or on file mode A 
— Maps the 3-character file type abbreviations to their real file types 
— Creates the list of service parts found on the tape 
— Checks service levels 
— Creates or adds to the service diskmap for this volume. 
e Then VMFREC performs the following processing for the specified ppfname or prodid (or, if the LIST 
operand is used, for each product or component in the list): 
1. VMFREC determines whether the product or component uses a product parameter file. To do this, tas 
it looks at the file type of the level identifier (located in the second tape file). 0 
— If the file type is crilnnI, the product or component uses a product parameter file. The rest of _~ 
this section describes the processing for products and components that use a product parameter 
file. The product parameter file from the highest-level minidisk in the search order is used to 
control the receive function. 
— If the file type is other than crilnn1, the product or component uses a product-specific EXEC. 
VMFREC does steps 5 and 6 page 712, then calls the product-specific EXEC and passes any 
parameters entered with the command or in the LIST file. For more information about 
product-specific EXECs, see the product documentation. yo 
2. VMFREC calls the VMFOVER EXEC to build a temporary product parameter file (file type ae, 
$PPFTEMP) containing the parameters for the component being processed. 
3. If a user exit is specified in the USEREXIT tag in the $PPFTEMP file, VMFREC calls the user 
EXEC with the parameters VMFREC and SET-UP. 
4. If the SETUP option 1s taken, VMFREC accesses the minidisks and/or directories required to set up 
the following access order: 
TASK 
APPLY ~~ 
DELTA Me 
BASE 
BUILD 
SYSTEM. 
5. VMFREC checks the PUT/COR option specified with the command (PUT is the default) against the 
tape descriptor (located in the first tape file) to make sure that the correct tape is mounted for the 
type of service you want to do. 
6. VMFREC positions the tape to the service files for the specified product or component. 
7. VMFREC does merge processing as follows: 
a. VMFREC locates the MERGE tag in the $PPFTEMP file. The MERGE tag may list one or 
more names of minidisk strings, such as DELTAI1 or LOCALI. 
b. VMFREC then locates the record for the first string name in the MDA section of the 
$PPFTEMP file. This record lists the minidisks in the sung in search order form from highest 
to lowest, left to right. 
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| | c. Beginning with the lowest search order pair in the string (the last two minidisks listed on the 
| right), VMFREC: 


( ; | 1) Calls the COPYFILE command with the REPLACE option and the OLDDATE option to 
= | copy all the files from the higher of the pairs in the search order to the lower. 


| 2) Erases the higher of the pair. 


| 3) Selects a new pair consisting of the higher of the previous pair and the next higher in the 
| string. 


| 4) Repeats the above steps for the new pair. 


| 5) Continues selecting pairs until the highest minidisk in the string has been merged. This 
| results in an empty minidisk at the highest level. 


| d. VMFREC look at the next string name (if any) in the MERGE record and repeats the merge 
| processing for that string. 


| 8. VMFREC calls one or more of the following part-specific EXECs to process the service tape and 
. | load the service files. The next tape file on the service tape contains a product contents directory 
( ; | that lists the service files. The RECSER section of the $PPFTEMP file identifies the part-specific 
7 | EXEC that handles each type of file and specifies the target string. The MDA section of the 
| $PPFTEMP file identifies the specific target minidisk in the string. 


| VMFRCAXL ~~ This EXEC receives the apply lists and exclude lists. 


| VMFRCAUX VMFRCAUX receives AUX files and renames the AUX file file types with the ISD 
| abbreviation for the AUX file and the PTF number from the top entry of the AUX 
| file. 


a | VMFRCUPD _ This EXEC receives source update files as follows: 


( ; | a. VMFRCUPD checks to make sure that the target does not already contain any 
= | update files for the component. If any update file exists, VMFRCUPD stops 
| processing. 


| b. VMFRCUPD searches the other accessed minidisks for files with the same file 
| name and file type as the update files that have just been received. 


| — If it finds an update shell with the same name, VMFRCUPD erases the 
| update shell, but retains the dependent information and the file mode 
| number. 


( : | — Ifit finds a complete update file with the same name, VMFRCUPD erases 
" | the new file. 


| VMFRCUPP _ This EXEC process uppercase English HELP files. 
| VMEFRCTXT ~= This EXEC receives text decks as follows: 


| a. VMFRCTXT checks to see if a text deck with the same file name and file type 
| exists in the target string. 


| — Ifa text deck with the same file name and file type exists on a previous 

| | level minidisk, the new deck is not received, and processing for that text 
| deck ends. This prevents cumulative text decks received from a previous 
| service tape from being duplicated in the data base. 


| — Ifa text deck with the same file name and file type exists on the target 

| minidisk, the new deck is received to replace the existing text deck. The 

| existing text deck is probably is text shell created by VMFREC, because 

| only one copy of a specific text deck is shipped on the service tape. If the 
| existing text deck is a full text deck (due to receiving the same service tape 
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twice or receiving more than one service tape on a single target), no harm is 
done by the overlay. 


b. VMFRCTXT checks the LTO (last text only) record in the $PPFTEMP file and 
processes the text deck as follows: 


— If LTO is set to NO, VMFRCTXT loads the text deck to the target. 


— If LTO is set to YES, VMFRCTXT compares the text deck prolog with the 
prologs of all other text decks that have the same file name and file type 
prefix (for example, TXT). VMFRCTXT keeps the text deck with the 
latest entries and creates text deck shells for the others. If the text deck you 
receive on the tape does not include all the entries from earlier text decks, 
VMFRCTXT writes a message to the receive exception log. 


c. VMFRCTXT processes the history (prolog) section of all the text decks on the 
target minidisk or directory. 


— Ifa source update file does not exist for the text deck (because the part is 
serviced by replacement), VMFRCTXT creates an update shell on the 
APPLY minidisk. 


— Ifa text deck does not exist in the target string, VMFRCTXT creates a text 
deck shell. 


VMFRCCOM This EXEC calls the VMFPLC2 command to receive update files without additional 
processing. 


9. After any needed part-specific EXECs finish processing, control returns to VMFREC with a return 
code. 


10. If a user EXEC is specified in the USEREXIT tag in the $PPFTEMP file, VMFREC calls the user 
EXEC with the parameters VMFREC and CLEAN-UP, and with a return code. 


Level Checking 


VMFREC EXEC does level checking to determine whether the level of service EXECs on the tape is the 
same as, or at a higher level than, the service EXECs on your system. 


The $LEVEL MAP file 


VMFREC INFO uses a file called $LEVEL MAP for service EXEC level checking. $LEVEL MAP is in the 
first tape file on the tape. The first line in the SLEVEL MAP is a comment that contains the tape type (PUT 
or COR) and the tape level. Two examples of this comment lines are: 


* SES PUT LEVEL 8901 


* SES COR LEVEL 8901A 


In the second example, the A in 8901A indicates the level of service EXECs that is on the tape. In this 
example, the A indicates one change was made for COR tapes after PUT 8901. 


Each entry after the comment contains four tokens. The first is the part file name, the second is the part 
executable file type, and the third and fourth are the part PTF numbered file types for each version of the 
service EXECs supported. The VM/XA SP Release 2 version is listed first. These last two columns allow a 
VM/SP Release 6 customer to map the VM/XA SP 2 PTF numbers to the corresponding VM/SP Release 6 
PTF numbers. Unserviced parts are shipped with a file type of the three-character abbreviation followed by 
a PTF number of 00000 (for example, EXC00000). 


An example of these entries follows. 
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* SES parts in the first tape file 
* XA/SP2 370/SP6 

VMFREC EXEC  €EXC12345 EXC12346 
VMFRCTXT EXEC  £XC12345 EXC12346 
$VMFMSG$ EXEC  EXC23123 EXC23124 
VMFLDS MODULE M0D12345 M0D12346 


Next in the $LEVEL MAP file are the PPF entries for the second file on the tape. Since there is a 
one-to-one relationship between PPF and product, the file name and file type are followed by only one 
column containing the PTF-numbered file type. 


An example of the PPF entries follows. 


* PPFs in the second tape file 


56643082 $PPF $PF12345 
5664167E $PPF $PF12346 


The Level Checking Algorithm 


VMFREC checks to ensure that a known level of the service tool is being used. It checks the following: 
e Installed service tool level 


VMFREC always reports the level of the service tool installed on your system by displaying the level 
found in the first record of the $LEVEL EXEC file. If no $LEVEL EXEC file exists then the level is 
reported as UNKNOWN. 


e Tape level, against installed level 


The service tool parts in files 1 and 2 of the service tape are compared to the parts in $LEVEL EXEC. If 
a mismatch is found then the level of the service tool parts on the tape Gif known) is reported. This will 
ensure that the user is aware that the levels differ. In this context a match is defined to mean: 


— Tape file 1: 


Parts from the tape must be equal in file name, file type, and file mode to the parts identified in 
$LEVEL EXEC. File name is checked against the names in column | and file type is checked 
against the columns listing the filetypes for the VM products affected by the PTF. 


— Tape file 2: 


Parts from the tape must exist in $LEVEL EXEC. File name is checked against the names on 
column | and file type is checked against the types in column 3. 


e Tape level, against tape inventory 


The service tool parts in files 1 and 2 of the service tape are compared to the parts in $LEVEL MAP. If 
a mismatch is found, a message indicates that a discrepancy exists within the tape itself. In this context a 
match is defined to mean: 


— Tape file 1: 


Parts from the tape must be equal in file name, file type, and file mode to the parts identified in 
$LEVEL MAP. File name is checked against the names in column | and and file type is checked 
against the types in column 3. 


— Tape file 2: 


Parts from the tape must exist in $LEVEL MAP. File name is checked against the names on column 
| and file type is checked against the types in column 3. 
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Return Codes 


VMFREC issues the following return codes: 


Return Code | Explanation 


No errors were encountered. 

Minor errors were encountered. Check $VMFREC $ERRLOG. 
There was a syntax error in the command. 

Merge processing error. 


Unexpected tag in PPF. 


The required file was not found. 


An unrecoverable error was encountered. 
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PUT | $PPF 
.$PPF 
APP/EXC LIST 
PART LIST 
SOURCE UPDATE :-MDA 
TEXT ‘-RECSER 
-MAGRO AUX 


SOURCE REPLACEMENT 


- VMFRCALX 
- VMFRCUPD 
- VMFRCTXT 

- VMFRCCOM 


VMFREC 


-APP/EXC LIST 


SOURCE UPDATE -UPDATE SHELL 


Cee TEXT PART 
MACRO AUX 
COPY/ASSEM 
TEXT SHELL 591 423 
CURRENT ete ee ear aes ae 
(PRODUCTION) 
193 294 192 291 123 
BASE DELTA APPLY LOCAL BUILD 


NOTE: The minidisk addresses shown are defaults for CP. 


( Figure 52 (Part 1 of 2). How VMFREC Works 
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Figure 52 (Part 2 of 2). How VMFREC Works 


VMFRCALX 


APPLY/EXCLUDE LIST 
-SOURCE UPDATE 
.TEXT/Text SHELL 
~PART LIST 
.MACRO/SOURCE 
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VMFREMOV EXEC 


The VMFREMOV EXEC procedure removes PTFs applied by the VMFMERGE EXEC procedure. 


Do not use this procedure to service any of the base components of VM/XA SP. Use this procedure when 
applying PTFs to System Network Architecture (SNA) products. 


Format 


The format of the VMFREMOV command is: 


VMFREMOV| prodid = PTF {pifnum | * } 


PTFLIST remlist 
CONVERT | lastfilemode | 


where: 


prodid 
is the ID of the product. 


PTF - mun 


removes the specified PTF (ptfnum is the file name of a PTF) or, if you enter * instead of a ptfnum, 
removes the PTFs listed in a remove list file named prodid REMLIST. This file must already be created 
and must be on a DELTA disk. 


PTFLIST remiist 
removes the selected PFTs in a remove list file named remlist REMLIST. This file must already be 
created and must be on a DELTA disk. 


CONVERT 
invokes the tool that creates the reqby log file, if one does not already exist, but does not remove any 
changes. 


lastfilemode 
specifies the file mode of the last DELTA disk. VMFREMOV assumes that the merge disk is always 
accessed as E and that all other DELTA disks are accessed as consecutive file modes between F and the 
lastfilemode. If you do not specify lastfilemode, then the file modes for the MERGE and DELTA disks 
are determined from the information in the VMFPARM file. Use the Jastfilemode parameter only if you 
know you have the correct disks accessed as the proper modes. 


If you wish only to create the reqby log and do not want to remove any changes, then use the CONVERT 
keyword. 
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How VMFREMOV Works 


VMFREMOV is a service process that removes PTFs applied by VMFMERGE. The EXEC procedure: 


1. Obtains data from the merge log and the service control file(s) to build the reqby log if one does not 
already exist. The reqby log contains a list of all dependent PTFs that must be removed if their requisite 
PTF is removed. 


e Ifa service control file for any of the PTFs is missing, then processing continues. However, the 
reqby log will be incomplete if the missing service control file contains requisites. If any SCFs were 
missing, processing ends after VMFREMOV completes the build of the reqby log. No PTFs are 
removed. 


2. Checks the merge log to insure that the PTF to be removed is currently merged. 
3. Reads the reqby log for the list of dependent PTFs to remove. 


4. Removes a PTF (for example, UVQ0007) that may supersede other PTFs (for example, UV00005). Note 
that the other PTF (UV00005) is no longer superseded and that its status is what it was prior to the merge 
of the primary PTF (UV00007) (that is, merged, superseded, or no status). aa 


If the prior status of UV00005 is no status, then VMFREMOV removes its dependents. a. 


5. Copies, from the DELTA disk to the MERGE disk, each element affected by the PTF being removed if 
previous service for an element is merged. If the element has not been merged, VMFREMOV erases the 
element from the MERGE disk. 


The very first line of a copied text deck is always a comment line consisting of the PTF name, and the 
date and time stamp. Any information on the :apartext entry is copied, but the first line is a comment. 


Note: A temporary file (with file type of OVMFMGLG) is created during this procedure to insure . 
system integrity. This file is erased during normal VMFREMOV processing. - 


6. Removes the element’s entry from the reqby log. If an element has other elements that are dependent 
pupon it, VMFREMOV also removes those dependent entries from the reqby log. 


7. Updates the merge log with the current status of the PTFs. The merged entry is commented out. 
Another comment is added to the end of the merge log (with a time and date stamp) indicating that the 
PTF has been removed. 


In the case where a PTF that supersedes another PTF is removed, the SUPERSEDED entry is 
commented out. 


Note: If you remove a change, VMFREMOV has no way of knowing if the change is a requisite of a change 
in another product. You should have made note of any cross-product requisite information during 
VMFMERGE processing (see page 696) to know which changes to remove manually. 


Messages 


DMSWRMOO02E _ File fn ft [f/m] not found. 

DMSWRM002W _ File /n ft [fm] not found. 

DMSWRMOOS8E _ Device vdevno invalid or nonexistent. 

DMSWRMOI7E _ Invalid device address vdevno. 

DMSWRMS20E __ Invalid operand: operand. 

DMSWRMS545E Missing operands. 

DMSWRM632E — 1/O error in EXECIO; RC-nn from command command. 
DMSWRM649E _ Extraneous parameter parm. 

DMSWRMO653E _ Error executing command. 

DMSWRM823E — PTF name] is listed as a dependent of PTF name2, but PTF name/ is not merged. 
DMSWRMS824W ss prodid VMFREQBY may be incomplete due to a missing SCF. 
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DMSWRMS857E 
DMSWRMS858E 
DMSWRMS859E 
DMSWRMS860E 
DMSWRM8611 
DMSWRM86021 
DMSWRM863E 
DMSWRM864W 
DMSWRM8¢65I1 
DMSWRM866W 
DMSWRM867E 
DMSWRM874E 
DMSWRM879W 
DMSWRM882E 


DMSWRM883W 
DMSWRMS888E 
DMSWRM892E 
DMSWRM893W 


VMFREMOV 


Disk address vdevno is listed more than once on the DELTA and/or MERGE entry records 
in the prodid VMFPARM file. 

The number of disk addresses on the DELTA entry record cannot exceed nine. 

Unable to find a tag entry record in the /n ft file. 


The prodid VMFPARM file has no disk addresses on the {MERGE|DELTA} entry record. 


Only one {MERGE|DELTA} entry record may appear in the prodid VMFPARM file. 
Accessing disk_type disk vdevno as fm. 

Change name thas been action|is no longer SUPERSEDED by name}. 

The MERGE disk vdevno must be linked read-write. 

PTF name will not be action because it is not status. 

Processing PTF name. 

No PTFs have been action. 

Invalid status status in prodid VMFMGLOG for entry PTF. 

Invalid entry found at line /ine in fn ft. 

Change name name appears more than once in the /n ft. 

File fn ft [fm] [from name] not found on any DELTA disks from the disks from the 
VMFPARM file. 

PTF name is not a part of product prodid and must be action in product prodid. 
Error in name SCF. No entry for element fn ft. 

PTF name has not been action. 

Incomplete processing, not all [required] PTFs were action. 


For a complete explanation of each message, refer to VM/XA SP System Messages and Codes Reference. 
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VMFSETUP EXEC 


The VMFSETUP EXEC uses the minidisk assignment section of the product parameter file to establish the 
correct minidisk access order for the component being serviced. It can also be used to release the accesses it 
established and restore the previous access order. VWMFSETUP is invoked by VMFAPPLY, VMFHASM, 
and VMFBLD. You can also invoke it from the command line. 


Format 


The format of the VMFSETUP EXEC is: 


VMFSETUP | prodid compname [PFFTEMP] [options ... JJ] 


options: 


ACCESS | RESTORE 
RETAIN mm m 


=| [ASM | APP| BLD | REC| ALL] 


where: 


prodid 
is the product number of the product to be serviced. For VM/XA SP, the product identifier is 56643082. 


compname 
is the name of the component to be serviced. The names for the VM/XA System Product Release 2 
components are CP, CMS, GCS, and DV. 


PPFTEMP 
indicates that the caller has created a $PPFTEMP file that contains only one component (keyword). If 
not specified, VMFSETUP calls VMFOVER to create a $PPFTEMP file based on the prodid $PPF file 
and any existing override file. 


options 


ACCESS 
indicates that a new minidisk access order should be set up. ACCESS is the default. 


Note: Ifa minidisk is in access mode read-write, and you have specified that minidisk as a read-only 
disk in your prodcct parameter file, VMFSETUP releases the minidisk and re-accesses it as a 
read-only disk. 


RESTORE 
indicates that the accesses should be released and the previous access order restored. 


REC | 
sets up the access order for VMFREC. 


APP 
sets up the access order for VMFAPPLY. Whenever VMFAPPLY invokes VMSETUP, it specifies 
APP. 


ASM 
sets up the access order for VMFHASM. Whenever VMFHASM invokes VMSETUP, it specifies 
ASM. ASM is the default option. 


BLD 
sets up the access order for VMFBLD. Whenever VMFBLD invokes VMSETUP, it specifies BLD. 
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ALL — 
sets up all the accesses specified in the minidisk assignment section of the product parameter file. 


| RETAIN mm mi... 
| each m indicates a file mode that is not to be used by VMFSETUP. 


How VMFSETUP Works 


If VMFSETUP is invoked from the command line rather than from another EXEC, VMFSETUP invokes 
VMFOVER. 


If the file named productid SSETUP exists, the current accesses are validated against the release section of 
productid $SETUP. If the accesses do not match, the user is notified and given the option of terminating or 
releasing everything but the A-disk. 


If the accesses match, the original accesses saved in the restore section of the file with the file name of the 
co product name and a file type of SSETUP are restored. If the RESTORE option was specified, VMFSETUP 
( processing is complete. 


If the ACCESS option was specified or chosen by default, VMFSETUP locates the minidisk assignment 
section (:MDA.) in the chosen component section of the product parameter file) VMFSETUP then saves the 
current minidisk access order in the restore section of productid SSETUP. 


Minidisks are accessed according to the process options specified. Table 20 shows the minidisk access order 
for each option: 


( — Table 20. Minidisk Accesses Established by VMFSETUP EXEC 


SYSTEM 


Finally, VMFSETUP does a QUERY SEARCH, displays the results on the screen, and stores the results in 
the log. In addition, these new accesses are saved in the release section of the file named productid SSETUP 
in the form needed to validate before a subsequent release. 


Note: Ifa minidisk is in access mode read-write, and you have specified that minidisk as a read-only disk in 
your prodcct parameter file, VMFSETUP releases the minidisk and re-access it as a read-only disk. 
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VMFVIEW EXEC 


The VMFVIEW EXEC invokes XEDIT to allow you to view the exception logs. Using the VMFVIEW | 
EXEC’s PF key assignments, you can: 


e View all the messages of a specific type 
e¢ View all the messages of a specific number 
e View the HELP screen for a particular message 


¢ Move backwards and forwards through the displayed exception log. 


The PF key assignments that the VMFVIEW EXEC uses are defined in a tailorable profile called 
VMFVIEWS PROFILE. See “The VMFVIEW profile file” on page 726 for a description of this profile. 


Format 


The format of the VMFVIEW EXEC is: 


VMFVIEW 


errlog [LAST|ALL] 


errlog: | 


Receive | VMFRec | $VMFRec —_ 
Apply | VMFApply | $VMFApp a 
Build | VMFBid | $VMFBld | BLD 


where: 
? 
causes a VMF VIEW help screen to be displayed. 


errlog 
is the exception log you want to view. Specify: 


Receive, VMFRec, or $VMFRec to view the receive exception log 
Apply, VMFApply, or SVMFApp to view the apply exception log 
Build, VMFBId, SVMFBld, or BLD to view the build exception log. 


LAST | 
specifies that only messages from the most recent run in the exception log will be displayed. LAST is the 
default for VMFVIEW. 


ALL 
specifies that messages from all runs in the exception log will be displayed. 
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Default PF Key Assignments 


The default PF keys for the VMFVIEW EXEC are: 


PFO01/13 - Help Display a HELP screen (see Usage Note 3) 
PF02/14 - All Display ALL messages (see Usage Note 4) 
PF03/15 - Quit Exit VMFVIEW 

PF04/16 - Exception Display CK:, MS:, RQ:, SV:, and WN: messages 
PF0Q5/17 - Status Display ST: messages 

PF06/18 - Build Display BD: messages 

PF07/19 - Backward Display previous screen of messages 
PF08/20 - Forward Display following screen of messages 
PF09/21 - OutCompRq Display RO: messages 

PF10/22 - Non-Stat Display all messages except ST: messages 
PF11/23 - Requisite Display RQ: messages 

PF12/24 - Severe Display SV: messages. 


Message Headers 


The message headers that appear in the exception logs are: 


BD 


CK 
MS 


RO 


RQ 


ST 
SV 


WN 


These are “build” messages that give information needed to rebuild the parts affected by the application 
of service. 


These are items that you must check. These messages contain information that may require user action. 


These are “mismatch” messages that indicate conflicting control information that must be investigated 
and corrected. 


These are “requisite out of component” messages. They indicate that PT Fs must be applied to another 
component. 


These are “requisite” messages that indicate that there are PTFs (in the same component) that are 
missing and must be applied. 


These are “status” messages. These message give useful information but require no further action. 


These are “severe” messages. These indicate problems that resulted in the termination of a process. 
These problems must be investigate and corrected. 


These are “warning” messages that must be investigated. They indicate situations that may or may not 
be a real problem. It is up to the user to decide after investigating the cause of the message. 


Appendix B. EXEC and Command Format Summaries 725 


VMFVIEW 


| Usage Notes: 


l. 


oe) 


PF keys are defined by the file VMFVIEW$ PROFILE. You can change the PF key assignments by 
editing this file. Instructions for tailoring the PF keys appear at the beginning of this file. 


The initial set of exception log messages displayed by VMF VIEW is defined in the file VMFVIEW$ 
PROFILE. The default is the “exception” category of messages. 


The Help PF key performs one of two functions, depending on the position of the cursor: 


a. When the cursor is on the command line or on a line with no message number, the VMFVIEW help 
screen will be displayed 


b. When the cursor is on a line that contains a message number, the help screen for the corresponding 
CMS message number will be displayed. If the requested help screen cannot be found, a message is 
displayed. 


The “All” PF key performs one of two functions, depending on the position of the cursor: 


a. When the cursor is on the command line or on a line with no message number, the “All” key causes 
all of the messages in the log to be displayed 


b. When the cursor is on a line that contains a message number, the “All” key causes all of the 
messages in the log with this message number to be displayed. Note that these keys are still qualified 
by the LAST|ALL command line option of VMFVIEW. 


To gather information about messages, you can issue commands such as FILELIST and XEDIT from 
the command line. 


You may find it useful to put a subset of messages into a separate CMS file. To do this you can use the 
XEDIT PUT command. An example follows: 


If you want to put all BD: (build) messages in a file to process separately, press the appropriate PF key 
to isolate this subset of messages. (The default is PF06/18.) Then enter the following command on the 
XEDIT command line: 


PUT * BUILD | 
This creates a CMS file with the name BUILD $ERRLOG. The PUT command changes the current line 


on the XEDIT screen. You can enter “TOP” on the XEDIT command line line to make the current line 
the top line of the file or press another PF key to view a new subset of messages. 


. You may find it useful to add the invocation of VMFVIEW to the service user exits. To do this, include 


the following commands in your user exit: 


parse upper arg execname flag retcode 
if function = 'CLEAN-UP' then do 
‘EXEC VMFVIEW' execname 


. If, while viewing messages from the LAST run, you wish to check messages in previous runs, use the 


“ALL” XEDIT macro. This macro resets the “SET SELECT” and “SET DISPLAY” XEDIT 
sub-commands that are used by VMFVIEW. To return to a view of only the LAST run, press one of the 
PF keys that is set to select a subset of messages. 


The VMFVIEW profile file 


VMFVIEW uses a profile file called VMFVIEW$ PROFILE. You can tailor this file to suit your needs. 


Figure 53 on page 727 shows the VMFVIEW$ PROFILE file supplied by IBM. 
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[ ; 
‘ee 


VMFVIEW 


KEKKEKEKKREREREER ER ERRRERERERREEKEKRRRKKEKRKEEREEEKERKKKEREKRERERERRERER 


* THIS PRODUCT CONTAINS RESTRICTED MATERIALS OF IBM. * 
* COPYRIGHT - 5664-308 " 
> ‘a. COPYRIGHT IBM CORPORATION - 1989 * 

LICENSED MATERIAL - PROPERTY OF IBM . 


KRKKEKEKKEKEEKEKERERER KEKE RRR EREERKREREKEKERKERKREKREEREERKERKRKEE 


Name: VMFVIEW$ PROFILE 
Function: Tailorable profile for VMFVIEW. 
Syntax of Entries in the Profile: 


* cmt 

VMFVIEW PFnn ( text ) key * cmt 
VMFVIEW INIT ( text ) key * cmt 
COMMAND xcmd 

MACRO = xmac 


* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* where cmt is a comment. 

= nn is a number between 1 and 24 inclusive. 
= text is the text to describe a PF key. If 
i necessary, this field is truncated to 9 
* characters or padded with blanks. 

ie key is one of the following: 

* 'HELP' ~ display help screens 

~ ‘ALL! - display all messages 

ss ‘QUIT’ ~ exit from VMFVIEW 

* 'BACKWARD' - display previous screen 

* 'FORWARD' - display following screen 
* 'XX2<,yy:<,Zz:<...>>> with NO spaces 

. ~ display messages with the 
x listed headers 

= "9XX2<,7yy:<,7ZZ:<...>>> with NO spaces 
= - display all messages except 
* those with the listed headers 
sl xcmd is an Xedit command. 

~ xmac is an Xedit macro. 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 


Usage Notes: 


1) Use an asterisk '*' to ‘comment out' old entries 
instead of deleting them or changing them directly. 
This will make it easier to recreate the original 
definitions. 


2) The valid headers are: 
BD:, CK:, MS:, RO:, RQ:, ST:, SV:, WN: 


3) It is recommended that PF keys 13-24 duplicate PF 
keys 1-12 because only PF keys 1-12 are displayed 
in VMFVIEW. If a PF key is not defined the Xedit 
default is used. 


Figure 53 (Part 1 of 2). VMFVIEW$ PROFILE 
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4) The entries in this profile are processed in the 
same order in which they appear. This means that 
you can override previous settings. 


oOo 
— 


You may use the Xedit command SET PFxx. If you do, 
the text describing that PF key will be blank. 


Xedit commands and macros must have their correct 
syntax. 


The 3 lines on the top of the screen and the 2 lines 
above the bottom line of the screen are reserved for 
VMFVIEW. 


| 
ae 


+ ee Fe * Fe FF K€ 
oO 
eee 

+ ee eH KH KF € € * 


KEREKEKRERKEKERRREKERERERREERERERRERKREKRE RRR KEKE KKEKERKEERKEEKRERERREKERRKEKEE 


VMFVIEW INIT (Exception) CK:,MS:,RQ:,SV:,WN: 
VMFVIEW PFQ1 (Help ) HELP 


VMFVIEW PFO2 (Al1 ) ALL 
VMFVIEW PFO3 (Quit ) QUIT = 
VMFVIEW PFO4 (Exception) CK:,MS:,RQ:,SV:,WN: - 


VMFVIEW PFO5 (Status ) ST: No 
VMFVIEW PFO6 (Build _ ) BD: 

VMFVIEW PFO7 (Backward ) BACKWARD 

VMFVIEW PFQ8 (Forward ) FORWARD 

VMFVIEW PFQ9 (OutCompRq) RO: 

VMFVIEW PF10 (Non-Stat ) 7ST: 

VMFVIEW PF11 (Requisite) RQ: 

VMFVIEW PF12 (Severe ) SV: 

VMFVIEW PF13 (Help ) HELP 

VMFVIEW PF14 (Al1 ) ALL oo 
VMFVIEW PF15 (Quit ) QUIT 

VMFVIEW PF16 (Exception) CK:,MS:,RQ:,SV:,WN: 

VMFVIEW PF17 (Status ) ST: 

VMFVIEW PF18 (Build _ ) BD: 

VMFVIEW PF19 (Backward ) BACKWARD 

VMFVIEW PF20 (Forward ) FORWARD 

VMFVIEW PF21 (OutCompRq) RO: 

VMFVIEW PF22 (Non-Stat ) -ST: 

VMFVIEW PF23 (Requisite) RQ: 

VMFVIEW PF24 (Severe) SV: 
KEKE KK RRR KKK Raa RR RK KEE 
COMMAND SET ENTER IGNORE COMMAND CURSOR HOME PRIORITY 30 7 
COMMAND SET CMDLINE BOTTOM 

COMMAND SET CURLINE ON 4 

COMMAND SET MSGLINE ON 2 2 OVERLAY 

COMMAND SET MSGMODE ON LONG 

COMMAND SET COLOR MSGLINE RED 

COMMAND SET COLOR CURLINE WHITE 

COMMAND SET COLOR FILEAREA YELLOW 

COMMAND SET SCALE OFF 

COMMAND SET ETMODE OFF 

COMMAND SET SHADOW OFF 

COMMAND SET PREFIX OFF 


Figure 53 (Part 2 of 2). VMFVIEW$ PROFILE 
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VMFZAP EXEC 


Use the VMFZAP EXEC procedure to apply ZAPs and to maintain a record of them in the ZAP log. 


Do not use this procedure to service any of the base components of VM/XA System Product. Use this 
procedure when applying PTFs to System Network Architecture (SNA) products. 


This EXEC uses the BASE disk, MERGE disk, and ZAP disk as inputs and produces an updated ZAP disk 
as output. 


Format 


The format of the VMEZAP EXEC is: | 


prodid 


where: 
is the ID of the product you want to ZAP. 


When you issue VMFZAP, you must specify the name of the product you want to ZAP. VMFZAP accesses 
the disks using file mode letters E-N. VMFZAP accesses the MERGE disk ahead of the BASE disk. When 
VMFZAP processing stops, your search hierarchy is restored. 


In order to uue VMFZAP, you MUST have an A-disk accessed in read/write mode. This disk MUST NOT 
be the ZAP disk, MERGE disk, or BASE disk. That is, the virtual address of your A-disk MUST NOT 
appear on the ZAP, MERGE, or BASE records of your VMFPARM file. 


How VMFZAP Works 


VMFZAP: 
1. Uses a parameter file to determine the virtual addresses of the ZAP, MERGE, and BASE disks. 
2. Reads the ZAP log and builds a list of TEXT file names with ZAPs applied to them. 


¢ Erases all TEXT files in this list from the ZAP disk. 
¢ Applies ZAPs to the first version of the TEXT file found among the other disks. 


. Erases the ZAP log. 
. Reads the merge log and builds a list of ZAPs that are currently superseded. 
. Reads the ZAP List for the names of all ZAPs you want to apply. 


N A FF W 


. Checks each ZAP name to see if it is superseded. If it is not superseded, then VMFZAP reads the 
control file for that ZAP. 


Control files for a product ZAP may contain information for ZAPping more than one text file. 
VMFZAP separates this information by text file name and processes the ZAP of each text file in the 
order they are listed in the control file. 


Checks each text file name to see if it resides on some disk other than the ZAP disk. It is an error if 
the text file resides on the ZAP disk already. 
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If the text file exists, VMFZAP writes a temporary file called S$}VMFZAP ZAP to the ZAP disk 
containing the ZAP control records for the current text file. 


Copies the text file to the ZAP disk under a temporary name of the format VMF$Tn TEXT, where n 
is a number determined by how many text files are affected by the ZAP currently being processed. 
When this temporary file has been successfully ZAPped it is renamed to its original name on the 


ZAP disk. 


7. Calls ZAPTEXT passing the SSVMFZAP name and the VMF$Tn file name to be ZAPped. 
Refer to “ZAPTEXT EXEC” on page 742 for more information about the ZAPTEXT command. 
8. Updates the ZAP log with the information about the TEXT file that was just ZAPped. 


9. Restores your disk search hierarchy once all ZAPs in the ZAPLIST have been processed. 


Messages 


DMSWZP002E 
DMSWZPO008E 
DMSWZP017E 
DMSWZP520E 
DMSWZPS45E 
DMSWZP649E 
DMSWZP653E 
DMSWZP856E 


DMSWZP858E 
DMSWMG859E 


DMSWMG860E 


DMSWZP861I 
DMSWZP862I 
DMSWZP863E 
DMSWZP864W 
DMSWZP865I 
DMSWZP874E 
DMSWZP875E 
DMSWZP876E 


DMSW ZP877W 
DMSWZP878E 
DMSWZP879W 
DMSWZP880E 
DMSWZP881E 
DMSWZP885I 


DMSWZP886E 
DMSW ZP887E 


File fn ft [fm] not found 

Device ydev invalid or nonexistent 

Invalid device address vdev 

Invalid operand : operand 

Missing operands 

Extraneous parameter parm 

Error executing command 

Disk address vdeyv is listed more than once on the {BASE, ZAP | DELTA} and/or 
MERGE entry records in the prodid VMFPARM file. 

Unable to find a tag entry record in the /n /t file. 

The prodid VMFPARM file has no disk addresses on the {BASE | MERGE | ZAP} entry 
record. 

Only one {BASE | MERGE | ZAP} entry record may appear in the prodid VMFPARM 
file. 

Accessing disk_type disk vdev as mode. 

ZAP name has been action 

The ZAP disk vdev must be linked read-write. 

ZAP name will not be action because it already is status 

Processing ZAP name 

Invalid entry found at line /ine in fn ft 

File fn ft [fm] not found on any disks from the VMFPARM file. 

The total number of disk addresses on the BASE and MERGE entry records cannot exceed 
nine. 

Jn TEXT was previously zapped but was not found on the ZAP disk. 

prodid ZAPLIST does not contain any unsuperseded zap names. No zaps will be applied. 
ZAP name name appears more than once in the fn ft [It will only be applied once. | 

Error in ZAPTEXT while processing fn TEXT. Text files affected by file name2 ZAP will 
not be saved on the ZAP disk. 

jn TEXT was found on the zap disk but was not zapped during the VMFZAP run. This 
file should not be on the ZAP disk. 

File prodid VMFZPLOG not found on the ZAP disk. No text files will be removed from 
the ZAP disk. 

File name name from the fn ft [fm] file is longer than 8 characters. 

Record number number from the fn ft [fm] file is longer than 80 bytes. 


For a complete explanation of each message, refer to VM/XA SP System Messages and Codes Reference. 
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VSEVSAM EXEC 


Use the VSEVSAM EXEC to obtain VSE/VSAM Assembler Language macros from the Licensed Optional 
Machine Readable Materials tape. The VSEVSAM EXEC creates the VSEVSAM MACLIB for you. Once 
the MACLIB is created, it contains all of the VSE/VSAM assembler language macros, and the following VSE 
macros: CDLOAD, CLOSE, CLOSER, GET, OPEN, OPENR, and PUT. 


The format of the VSEVSAM EXEC is: 


Example of Using VSEVSAM 


Before invoking the VSEVSAM EXEC, complete the following: | 
1. Mount the Licensed Optional Machine Readable Materials tape at virtual address 181. 


2. Load the seven VSE macros from the Product Tape to MAINT 393 or a minidisk of your choice. (As 
long as the macros are available when VSEVSAM is invoked, the actual minidisk used is not critical.) 


Note: Because the seven VSE macros (CDLOAD, CLOSE, CLOSER, GET, OPEN, OPENR, and PUT) 
will be loaded into the MACLIB, they can be erased from the disk after the MACLIB is created. 


To invoke VSEVSAM EXEC, enter: 
vsevsam Hi 
Once invoked, VSEVSAM EXEC prompts you for information. For example, the system responds: 


DMSWVV797IT "QUIT" may be entered in response to any query to 
end processing. : 


DMSWVV788R Are the macros to be read from tape or are 
they already on disk? Reply TAPE or DISK. 
If a default of TAPE is to be used, press "ENTER." 
For this example, you read the macros from disk. Enter: 
disk @ 
The system responds: 
DMSWVV790R If the default library name of "VSEVSAM" is to be 
used, press "ENTER." Else, enter the name to be 
used for the library. 


You want to call the library V;SAMMACS, so enter: 


vsammacs @ 
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The system responds: 


DMSWVV791I The library name will be "VSAMMACS." 
Press "ENTER" to continue, else enter | 
"QUIT" or the name to be used for the library. 


Because VSAMMACS is the name we want to call the library, press: 
Ei 
The system responds: 


DMSWVV808R Macro library libname will be erased. 
Press "ENTER" to continue or type "QUIT" to exit. 


Because we want to erase old versions of the library that might be on our A-disk, press: 
7 on 
The system responds: 

DMSWVV793I Maclib generation completed. 


DMSWVV792R Are the macros to be erased from disk? 
Reply (YES | NO). Press “ENTER" for default 


of "YES." 
We want to erase the macros from disk, so press: a 
; Ne 

a r 
The system responds: 

DMSWVV8021 Macros erased - VSEVSAM processing complete. 

Ready; 
Messages om 


DMSWVV788R Are the macros to be read from tape or are they already on disk? Reply TAPE or DISK. 
If a default of TAPE is to be used, press “ENTER”. 

DMSWVV789W Invalid response. 

DMSWVV790R If the default library name of “VSEVSAM7” is to be used, press “ENTER”. Else, enter the 
name to be used for the library. 

DMSWVV791I The library name will be /ibname. Press “ENTER” to continue, else enter “QUIT” or the 
name to be used for the library. 

DMSWVV792R Are the macros to be erased from disk? Reply (YES | NO). Press “ENTER” for default 
of “YES”. 

DMSWVV793I Maclib generation completed. 

DMSWVV794E Error in maclib generation. 

DMSWVV79SE Error reading macros from tape. 

DMSWVV796E Error reading from “VSEVSAM SCAN” file. 

DMSWVV797I_ “QUIT” may be entered in response to any query to end processing. 
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DMSWVV798R 


DMSWVV799E 
DMSWVV800E 
DMSWVVS801I 
DMSWVV802I 
DMSWVV808R 


DMSWVV809E 


VSEVSAM 


The VSE/VSAM Optional Source Statement Library tape must be mounted as virtual 181. 
If it is not, enter “QUIT” here and have the tape mounted. Else, press “ENTER” to 
continue. 

Error reading from “VSEVSAM SCAN?” file - all macros may not be erased. 

One of the files needed for maclib generation is missing. 

Arguments entered are ignored. 

Macros erased - VSEVSAM processing complete. 

Macro library /ibname will be erased. Press “ENTER” to continue or type “QUIT” to 
exit. 

Error copying “VSEVSAM SCAN?” file from S-disk to A-disk. 
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ZAP MODULE 


ZAP is a CMS command that changes or dumps MODULE, LOADLIB, or TXTLIB files. It may be used 
to change either fixed or variable length MODULE files. It is for use by system support personnel only. 


Input control records control ZAP processing. They can be submitted either from the terminal or from a 
disk file. Using the VER and REP control records, you can verify and replace data or instructions in a 
control section (CSECT). Using the DUMP control record, you can dump all or part of a CSECT, an entire 
member of a LOADLIB or TXTLIB file, or an entire module of a MODULE file. 


Format 
MODULE | 
LOADLIB ¢ [ libname! ... libname3 | [option ...[ )] ] 
TXTLIB 
Options: 
TERM PRINT 
INPUT filename NOPRINT 
where: 
MODULE 
LOADLIB 
TXTLIB 


indicates the type of file that you want to change or dump. 


libname 
is the file name of the library containing the member you want to change or dump. You can specify one 
to three library names. This operand is valid only for LOADLIB and TXTLIB files. 


options... 


TERM 


PRINT 
NOPRINT 


indicates that input to the ZAP service program is submitted through the terminal. If you specify 
TERM, the prompting message ENTER: is issued, and you can then enter input control records up to 
80 characters long. If you specify PRINT with TERM, all output prints on the printer, but only 
error messages display at the terminal. If you specify NOPRINT with TERM, nothing prints on the 
printer, and all output except control records displays at the terminal. See Table 21 on page 735. 


NOPRINT 


specifies that input is submitted from a disk file called file name. This file must have a file type of 
ZAP, and must be a fixed 80-byte sequential file residing on any accessible device. If you specify 
PRINT with INPUT file name, all output produced by the ZAP service program prints on the 
printer. In addition, commands in error, control records in error, and error messages display at the 
terminal. If you specify NOPRINT with INPUT file name, nothing prints on the printer, and all 
output displays at the terminal. See Table 21 on page 735. 


INPUT filename bey 
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Table 21. Valid Options and Their Output 


ae PRINT NOPRINT 


Everything prints on the printer. Commands | Nothing prints on the printer. Everything 
in error, control records in error, and error displays on the terminal. 
messages display on the terminal. 


Everything prints on the Printer. Error Nothing prints on the printer. Everything 
messages display on the terminal. except control records displays on the 
terminal. 


Input Control Records 


There are eight types of ZAP control records: 


DUMP 

NAME 

BASE 

VER or VERIFY 
REP 

LOG 
COMMENT 
END. 


The ZAP program can accept only 80 characters of data for each control record. ZAP control records are 
free-form and need not start in position one of the record. Separate all information by one or more blanks. 
All address fields including disp (displacement) fields in VER and REP control records must contain an even 
number of hexadecimal digits, to a maximum of six digits (X'OD', X'02C8', X'014318'). Data fields in 
VER and REP control records must also contain an even number of hexadecimal digits. 


If you want, you can separate the data anywhere by commas (for example, 83256482 or 8325,6482). The 
commas have no effect on the operation. 


Note: Do not use blank spaces as separators within data fields. 


The program sets the NOGO switch on if it finds a control record in error. A file cannot be changed if the 
NOGO switch is turned on. The next valid NAME record turns the NOGO switch off. This means that if 
the control record is the NAME record, all succeeding records are ignored until the next NAME, DUMP, or 
END record. For any other error, only REP control records that follow are ignored. 


DUMP Control Record 


The DUMP control record allows you to dump a portion or all of a specified control section, or the complete 
member or module. The format of the output of the dump is hexadecimal with an EBCDIC translation of 
the hexadecimal data. 


The DUMP control record is optional and resets the NOGO switch off. The DUMP control record must not 


immediately precede a BASE, VER, or REP control record. A NAME control record must precede the 
BASE, VER, and REP control records (if any) that follow a DUMP control record. 
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Format: 


ALL 


modulename 


DUMP memaemame | — [ startaddress [endaddress | | 


where: 


membername 
is the name of the member you want to dump, or the member that contains the CSECT(s) you want to 
dump. This member must be in one of the libraries you specify on the ZAP command. 


For a CMS TXTLIB, the format of the dump control record requires that you specify both membername 
and CSECTname. Because the library directory does not contain member names, any word may be used 
to replace membername. The program searches for only the second name following the dump eperene 
therefore, the second name must be CSECTname. 


modulename 
is the name of the module you want to dump, or the module that contains the CSECT(s) you want to 
dump. If you specify a module that has no loader table, the program dumps the entire module. 


CSECTname 
is the name of the control section that you want to dump. If you do not specify CSECTname, the 
program dumps only the first CSECT. CSECTname is required for CMS TXTLIBs, but is optional for 


OS TXTLIBs, LOADLIBs, and MODULE files. (See the discussion of CSECTname in “NAME Control 


Record” on page 737). You must not specify CSECTname for a module created with the NOMAP 
option. 


startaddress 
is the location within the specified CSECT where you want the dump to begin. This must be two, four, 
or six hexadecimal digits. The start address is the displacement from the beginning of the CSECT. For 
example, to start dumping at address 08 in a CSECT that begins at location X'400', you specify start 
address X'08', not X'0408'. 


endaddress | 
is the last address you want to dump. This must be two, four, or six hexadecimal digits. If you do not 
specify endaddress, the program dumps from startaddress to the end of the CSECT. Note that start and 
end addresses apply only when you specify CSECTname. 


ALL 
tells the program to dump all CSECTs within the member or module you specify. You can specify ALL 
for MODULE files, LOADLIBs, and OS TXTLIBs, but not for CMS TXTLIBs. To dump all the 
CSECTs in a member of a CMS TXTLIB, you must issue a separate DUMP control record for each 
CSECT. 


7 


Usage Notes: 


1. Displacements listed in the dump output for a module file are calculated from the beginning location of 
the module. Therefore, the addresses in the output may differ from the displacements within a CSECT. 


2. Ifa DUMP control record references a TXTLIB file that contains ORG statements causing more than 
one occurrence of an address, data found at the first occurrence is displayed, but any subsequent 
redefinition of data for the same location is ignored. 
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NAME Control Record 


The NAME control record specifies the member or module and CSECT that contain the data you want the 
ZAP operation to verify or replace. The NAME control record must precede the BASE, VER, and REP 
control records. If it does not, the program sets the NOGO switch on. 


Format: 


modulename 


NAME fesiran | | csectname | 


where: 


membername 
is the member that you want to search for the desired CSECT. 


( modulename 
“ is the module that you want to search for the desired CSECT. 


CSECTname 
is the name of the control section you want to change. 


Usage Notes: 


1. You must specify CSECTname if the CSECT you want to change is in a CMS TXTLIB (that is, a 
TXTLIB created by the TXTLIB command from CMS TEXT decks that do not have a NAME card 
ieee following the END card). The directory of a CMS TXTLIB contains only CSECT names and no 
( , member names. Select a word to replace membername as the first entry following the NAME operand in 
the NAME statement for a CMS TXTLIB. 


Note: The word you specify for the membername for a CMS TXTLIB should be a meaningful name. 
The file name of the LOG control record is determined by the membername or modulename you 
specify in the NAME control record. 


2. The CSECT name you specify in the NAME record is compared with CSECT names in the directory. If 
the CSECT(s) match and no member name match is found, the member selected is the one that contains 
the CSECT name. | | 


( | 3. CSECTname is optional if the CSECT you want to change is a LOADLIB or an OS TXTLIB (that ts, a 
i TXTLIB created by the TXTLIB command from CMS TEXT decks that have a NAME card after the 
END card). The dictionaries of the specified libraries are searched for the member name and the 
member is then searched for the CSECT name, if you specified one. If you do not specify CSECTname 
for a LOADLIB or an OS TXTLIB, the program uses the first control section. 


4. CSECTname is optional fora MODULE file. The module named in the NAME control record is found 
and, if you specify CSECTname, the first record is read to determine the number of records in the 
module and the availability of a loader table, which the program can then search for CSECTname. If 
you do not specify CSECTname, the program uses the beginning location of the module. You cannot 
specify CSECTname if the module was created with the NOMAP option. 
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BASE Control Record 


The BASE control record adjusts displacement values for subsequent VER or REP control records for a . 
CSECT whose starting address is not location zero in an assembly listing. 


The BASE control record is optional. See the discussion under “VER or VERIFY Control Record” on 
page 738. If you specify the BASE control record, it must follow the NAME record, but it need not follow 
the NAME record immediately. For example, you could have the following sequence of control records: 
NAME, VER, REP, BASE, VER, REP. 


Format: 
BASE — address 


. where: 


address — 
is the starting address of the CSECT. It must be two, four, or six hexadecimal digits. . 


Usage Note: If you do not specify a CSECTname in the NAME control record, you cannot specify any 
BASE value other than 00. 


Example: For a CSECT starting at location X'400', you specify BASE 0400 in the BASE control record. If 

a subsequent VER card requests verification of location X'0408', BASE 0400 is subtracted from X'0408', 

and the program verifies location X'08' in the CSECT. This example applies if you spotty TXTLIB, 

LOADLIB, or MODULE and the module map is present. 

However, if no module map is present fora MODULE file (that is, the module was generated with the ey, 
NOMAP option), then all operations are done as if the BASE address is location X'0'. For example, if you 

specify a BASE of X'400' and the address you want to look at or change in X'408', then you must specify 

X'08' and not X'408' in the REP and VER control records. The address in this case is from the start of the 

module. 


VER or VERIFY Control Record 


The VER control record requests verification of instructions or data within a CSECT. If the verification 
fails, the program does not do a subsequent REP operation until it finds another NAME control record. / 


The VER control record is optional. More than one VER record can follow a single NAME record. 


Format: 


| VERIFY 


VER 


where: 


disp 
is the displacement from the start of the CSECT containing the data to be inspected, if you did not 
submit a BASE control record for this CSECT. disp can also be the actual location of the data to be 
inspected, if you did submit a BASE control record. disp must be two, four, or six hexadecimal digits. 
This displacement does not have to be aligned on a fullword boundary. If this displacement value is 
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outside the limits of the CSECT specified by the preceding NAME control record, the VERIFY control 
record is rejected. | | 


data | 
is the data against which the data in the CSECT is compared. This must be an even number of 
hexadecimal digits. 


Usage Note: If the VER control statement references data in a TXTLIB file that is later redefined by ORG 
statements, only the first data definition is verified. 


Example: If the location you want to verify is X'3CC', and the CSECT begins at location X'2B0', you can 
enter: | 


base 02B0 & 
ver 03CC data 


or you can omit the BASE control record, subtract the CSECT start address from the address of the data, 
and enter: 


ver 011C data @ 
REP Control Record 


The REP control record changes instructions or data at the specified location within the CSECT that you 
specify in a preceding NAME control record. The data specified in the REP control record replaces the data 
at the CSECT location specified by the disp operand. This replacement is on a one-for-one basis; that is, one 
byte of data defined in the control record replaces one byte of data at the location that you specified. If the 
replacement fails, the program does not do additional REP operations until it finds another NAME control 
record. 


The REP control record is optional. More than one REP record can follow a single NAME record. 


Format: 
| REP disp data 


where: 

disp 
is the displacement from the start of the CSECT of the data you want to replace (if you did not submit a 
BASE control record for this CSECT). disp can also be the actual location of the data if you did submit 
a BASE control record. disp must be two, four, or six hexadecimal digits. This displacement need not 
address a fullword boundary. If this displacement value is outside the limits of the CSECT being 
changed, the program does not do the replacement operation. 


data 
is the data that is to replace the data in the CSECT. This must be an even number of hexadecimal digits. 
Usage Notes: 


1. Although you do not have to verify a location before replacing data, you should do so to make sure that 
the data being changed is what you expect it to be. 


2. If the REP control statement references data in a TXTLIB file that is later redefined by ORG statements, 
the replacement of data takes place at the first occurrence of the data address of the TXTLIB member. 
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Example: If the location you want to replace is X'3CC', and the CSECT begins at location X'2B0', you 
can enter: 


base 02B0 & 
rep 03CC data @ 


or you can omit the BASE control record, subtract the CSECT start address from the address of the data, 
and enter: 


rep 011C data 


LOG Control Record 


The LOG control record lets you specify, after you apply a fix, a unique fix number, which is recorded in a 
log file for the module or member. The filename of the log file is the same as membername or modulename in 
the NAME control record. 


Format: 


fixnum filetype [user data | Se 


ZAPLOG 


where: 
fixnum | 

specifies the number associated with the fix. Its length may vary from one-to-eight alphameric 

characters. | foON 
file type ed 


specifies the file type of the log. The default is ZAPLOG. 


user data 
specifies any data that you want to enter into the log. If you specify user data, you must specify file type. 


Usage Notes: 


1. The LOG control record is optional and is allowed only if valid NAME and REP control records are 
found. The file name is obtained by the log routine from modulename or membername in the NAME _ 
control record. However, if no LOG control record is found, a dummy log record is written at the end . ; 
of the user’s valid REPs. nl 


2. Log multiple names by including a LOG control record after each name. If the LOG record is not 
included after each name, error message DMSZAPO70E results. Processing continues after the error 
messages occur. 


3. The LOG record is 80 bytes in length and contains the following information: 


¢ Columns 1-63 contain the fixnum and, if specified, the file type and user data 
¢ Columns 64-80 contain the date and time of the ZAP. 


740 Installation and Service 


ZAP 


COMMENT Control Record 


The ZAP program ignores COMMENT control records. If the PRINT option is in effect, the program prints 
the comments. 


Format: 


* comment 


There must be at least one blank following the asterisk (*) before you enter the text. 
END Control Record 


The END control record ends ZAP processing. The END record is required and must be the last control 
record for input from the console. 


Format: 


END 


Special Considerations for Using the ZAP Service Program 


Before using the ZAP command against MODULE files, you can use the MODMAP command to determine 
whether a module map exists and what it contains. 


When a ZAP input file has more than one pair of VER and REP control records, and a VER control record 
(other than the first) fails, you must remove the records prior to the failing record and correct the error 
before you issue the ZAP command again. Otherwise, the file being changed returns to its original status. 


The REP control record cannot be used to place data in an undefined area such as a Define Storage area. If 
any part of a data field specified in a pair of VER and REP control records is an undefined area, the system 
displays warning message DMSZAP248W, and no data replacement occurs. If you do not issue a VER 
control record prior to the REP control record, some change to data may result. User-defined data may be 
inserted in undefined areas of text files by using the REP statement described under the LOAD command. 


If the file to be dumped contains undefined areas (such as a DS or ORG statement in a TXTLIB member), 
the hexadecimal portion of the dump contains blanks to indicate that the corresponding positions are 
undefined. 


VER and REP control words can be used to change TXTLIB members produced by FORTRAN compilers 
that store the length of the compiled text in the END card rather than in the ESD card. However, if a 
member of this type contains multiple CSECTs, only the first CSECT can be changed by the ZAP program. 


The TXT records should be in ascending address order. If ZAP finds a TXT record with an address higher 
than the specified address, it stops scanning for the specified address. This means that ZAP control records 
affect only the data at the first occurrence of the address. 


When applying ZAPs to a text deck created by a compiler, be aware that some compilers, such as 


FORTRAN, may generate a text deck in which the TXT records are not in ascending address order. 
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ZAPTEXT EXEC 


ZAPTEXT EXEC modifies or dumps individual text files. Use ZAPTEXT like the ZAP service program, but 
only for text files, not for MODULEs, TXTLIBs, or LOADLIBs. (Use ZAP to process MODULEs, 
TXTLIBs, and LOADLIBs.) ZAPTEXT uses the same control information as ZAP and can also use the 
EXPAND ZAP control word. The user’s A-disk must be accessed as read/write to use ZAPTEXT. 


Format 


The format of the ZAPTEXT EXEC is: 


ZAPTEXT fn [ft [fm] ] [(options: ...[ )]] 


Options: 


[INPUT filename | | PRINT rs 
NOPRINT ! ) 


where: 


fn ft fm | 
is the file ID of the text file that you want to change. If you do not specify the file type or file mode, the 
system assumes a file type of TEXT and a file mode of Al. The file mode must specify a read/write disk. 


. \ 
options... 
P ee 
INPUT file name : 
identifies the file that has the ZAP control records. This file must: 
e Have a file type of ZAP, and 
e Be a fixed 80-byte sequential file that resides on any accessible disk. 
If you do not specify file name, it defaults to whatever you specify as fn on the ZAPTEXT command. 
PRINT | 
prints all output produced by ZAPTEXT on the printer. The system also displays error messages, aN 
commands in error, and control records in error at the terminal. a io 
NOPRINT 


does not print anything on the printer, and instead displays all output at the terminal. 


ZAPTEXT Input Control Records 

Control Records Also Used by ZAP 

ZAPTEXT uses the same control information as the current ZAP service program, with the addition of the 
EXPAND control record. The ZAP service program ignores any EXPAND control records. Refer to “Input 
Control Records” on page 735 for information about the control records, other than EXPAND, that 
ZAPTEXT uses. 


Use the ZAP control records with ZAPTEXT according to ZAP’s TXTLIB conventions. 
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EXPAND Control Record 


The EXPAND control record lets you increase the size of a named control section contained in the text file. 


Format: The format of the EXPAND control record is: 


EXPAND csect size [ , csect size ... | 


where: 


csect 
specifies the symbolic name of a control section whose length you want to increase. 


Size 
specifies the decimal number of bytes for the system to add to the control section length. The system 


initializes the added bytes to binary zero. The maximum number of bytes for each control section that 
you indicate 1s 4095. 


Control Record Usage Notes 


1. Each control record may have multiple entries, but you must separate them with commas. Do not spill 
an entry onto the next line. 


2. The system processes all EXPAND control records before any other control records, regardless of their 
position in the control file. 


3. The effective length of the expansion, which is the actual number of bytes added to the control section, 
may be greater than the length that you specify for the expansion. This may occur if, after the specified 
expansion, the system must add padding bytes to align the next control section or common area. 


4. When you increase a control section’s size, it may affect the offset address of any following control 
section. This is important when you determine values for BASE, REP, and VER control records. Use 
the effective expansion lengths when you are determining control section offsets. 


EXPAND Command 


ZAPTEXT calls EXPAND if you specify an EXPAND control record in the ZAP control file. Use 
EXPAND to add space to a program in object deck form. The system creates object decks when you 
assemble or compile a source program. This is especially useful when you do not have the source code for a 
program or the program does not have a patch area. 


Note: EXPAND can add extra space only at the end of named control sections (CSECTs). EXPAND 
cannot expand private code (unnamed CSECT) and common areas (named or unnamed). 


Do not increase the length of a program beyond its design limitations. For example, if you add space 
to a control section beyond the range of its base register addressability, that space is unusable. 
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Format 


The format of the EXPAND eonunand iS: 


EXPAND fn1 [ft1 [fm [ fn2 | ft2 [fm2]]}]] [ (options: ... [ ) | | 


Options: . 


INPUT filename | | PRINT | 


CSECT csect SIZE size NOPRINT 


where: 


fnl ftl fml 
identifies the input text file that the system expands. The file must have valid object deck information, ue 
like that created by an assembler or compiler. If you do not specify the file type or file mode, the system | 
assumes a filetype of TEXT and filemode of Al. 


Note: EXPAND assumes that the input text file follows OS/VS standards and that the OS/VS Linkage 
Editor will accept it without error. The system does a limited check for errors. If the input file is 
invalid, the system may not expand the text file correctly. 


Jn2 ft2 fm2 | 
identifies the output text file that the system creates. You can use an equal sign (=) for any of the file 
identifiers to indicate that it is the same identifier as fn/, ft1, or fml. The default fileid is $fnJ = =. 
The system truncates the file name (fn/) to 7 characters before appending the $. In any case, fm2 must — 
be a read/write disk and cannot be an asterisk (*). 


e 


options... 


INPUT file name 
identifies an EXPAND input file that contains EXPAND control records. If you do not specify 
INPUT, the file name defaults to the name of the text file that you are expanding (fn/). The file 
type must be EXPAND. The system searches all accessed disks for this file. 


Do not specify this option with the CSECT or SIZE options. 


CSECT | a 
specifies the symbolic name of a control section whose length the system will increase. If you specify = £“~ a 
CSECT, you must also specify SIZE. 


Do not specify CSECT with the INPUT option. 


SIZE 
specifies the decimal number of bytes that the system adds to the control section length. The system 
initializes the added bytes to binary zeros. The maximum number of bytes for each control section is 
4095. If you specify SIZE, you must also specify CSECT. 


Do not specify SIZE with the INPUT option. 


PRINT 
prints on the printer all output that EXPAND produces. In addition, the system displays error 
messages, commands in error, and control records in error at the terminal. 


NOPRINT 
does not print any output on the printer, and instead displays it at the terminal. 
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Messages 


After the system expands each CSECT that you specified, the system issues a message indicating the 
following: 


— The number of bytes added to the control section. 


Whether the number of bytes added is greater than the length that you specify for the expansion. 


This may occur if, after the specified expansion, the system must add padding bytes to align the next 
control section or common area. 


The offset, relative to the start of the specified control section where the expansion began. 


If the system finds an error during processing, it stops the update and does not do the expansions. 
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Appendix C. VM/XA System Product Starter System 
Information 


This section presents the following information: 
e The minimum hardware configuration needed to generate VM/XA System Product. 


¢ Sample files that IBM provides with the VM/XA System Product 
(For a sample product parameter file, see “A Sample Product Parameter File” on page 402.). 


¢ Allocations of the system residence device for starter systems. 


e Minidisk maps of 3350, 3375, 3380, 3380-E4, and 3380-K system residence devices, based on sample 
directories. 


Minimum Hardware Configuration 


The minimum hardware configuration needed to generate VM/XA System Product is: 
¢ One processor (that supports VM/XA SP) with: 


— Processor in 370-XA mode 

— At least 4 megabytes of real storage 
— One processor unit 

— One processor controller 

— One channel processor. 


e One system console 
¢ One printer 


e Direct access storage devices. The number required depends on the type of DASD used. 


DASD Type Number of DASD 
3350 4 
3375 3 
3380 2 
3380-E4 
3380-K l 


e One magnetic 9-track tape unit with data density of 6250 BPI 
(A second tape unit is recommended, but not required.) 


¢ One operator’s console. 


IBM supplies the following VM/XA SP starter systems: 


3350 
3375 
3380 (for 3380, 3380-E4, and 3380-K DASD). 
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DMSNGP ASSEMBLE 


DMSNGP ASSEMBLE (CMS Nucleus Generation Profile) 


This profile is part of the Starter System. Within this file, you must change CYLADDR =? to the address of 
the starting cylinder or block at which the nucleus is to be written. Also, you may want to change the 
VERSION and INSTID to your-own names. Change these to whatever is appropriate for your installation. 
NGP TITLE 'DMSNGP (CMS) VM/XA SYSTEM PRODUCT 5664-308' 
EJECT : 
DMSNGP CSECT | 
DEFNUC SYSDISK=190, * S-disk address m3 
YDISK=19E, * Y-disk address ~ 
HELP=19D, ~ * Help disk address - 
LANGID=AMENG, * Default is American English i 
DBCS=NO, * Default is not a DBCS lang * 
LANGLEV=5, * DCSS ID for multiple DCSS * 
SAVESYS=NO, * USING CMS IN DCSS YES OR NO * 
SYSNAME=CMS , * Name of above DCSS to save * 
USEINST=YES, * Using EXEC/XEDIT in DCSS - i 
INSTSEG=CMSINST, * Name of above DCSS to save . Le 
REWRITE=YES, * Write nucleus yes or no - 
IPLADDR=190, * Address of where to write = 
CYLADDR=?, * CYL/BLK OF WHERE TO WRITE : 
IPLCYLO=YES, * write ipl text on cyl 0 " 
VERSTION=?, * VM/XA CMS = 
INSTID='VM/XA CONVERSATIONAL MONITOR SYSTEM' 
END 
pe 
- 
ae 
\ 
Mie 
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HCPRIO ASSEMBLE 


Sample HCPRIO ASSEMBLE File 


IBM supplies the following sample file with VM/XA SP. It is only a sample file, and must be tailored to 
your installation before it can be used. 


RIO TITLE 'HCPRIOXA - HCPRIO FOR VM/XA SYSTEM PRODUCT ' 


KKKKEKKERERRRRKRERKRERKERERRERERREKRRRERKREKKREEERRERERREREREREKRRKKER 


Fae Virtual Machine / System Product 5664-308 rae 
ene Contains restricted materials of IBM nae 
ke Copyright (c) IBM _ Corporation 1988 alialal 
RAE’ Licensed Materials - Property of IBM AT 


oo Refer to Copyright Instructions: Form 6120-2083 TR, 


KEKKEKKEEKKRKKERKKEREREKREKRERERRREKKRRKERRREKREREKREEKKRKEREKREKRERKKRKEKEE 
KEKEKEKEKKKREREREKEERERKEREEREEREKRKRKRERERRERERERREEKRKEREREKEREKRE 
* 


* MODULE NAME - HCPRIO 


* 


DESCRIPTIVE NAME - DEFINITION OF REAL DEVICES 


FUNCTION - TO DEFINE THE REAL DEVICES 


REGISTER CONVENTIONS - SYMBOLIC REFERENCES TO REGISTERS ARE 
OF THE FORM "RX" WHERE X IS A NUMBER 
RANGING FROM 0 TO 15. 


PATCH LABEL - NONE 


MODULE TYPE - DATA 


ATTRIBUTES - RESIDENT, DATA-ONLY 
MACROS - 


RDEVICE - DEFINE REAL DEVICES 
RIOGEN - END REAL DEVICE GENERATION 


GENERAL COMMENTS - THIS MODULE IS THE USER'S RESPONSIBILITY. 
THIS SAMPLE IS BASED UPON THE STARTER IOCP 


* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* — PROCESSOR - ASSEMBLER H (VERSION 2) 
* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* INPUT FILE. 
* 


KEEKEKKEKEKRKEKRKEREREREEREREREREEKRRERRRREERRERREERERREREKREREKRKRKRREKRERERRKREERERKREEE 


PRINT NOGEN 

EJECT 
THE RDEVICE MACROS ARE CODED HERE, ONE FOR EACH DEVICE OR 
GROUP OF DEVICES 


RDEVICE DEVTYPE=3420, FEATURE=DUALDENS , MODEL=6 , DEVNO=(070,8) 
RDEVICE DEVTYPE=3420, FEATURE=DUALDENS ,MODEL=6 , DEVNO=(170,8) 
RDEVICE DEVTYPE=3420, FEATURE=DUALDENS , MODEL=6 , DEVNO=(270,8) 
RDEVICE DEVTYPE=3420, FEATURE=DUALDENS ,MODEL=6 , DEVNO=(370,8) 
RDEVICE DEVTYPE=3420, FEATURE=DUALDENS ,MODEL=6 , DEVNO=(470,8) 
RDEVICE DEVTYPE=3420, FEATURE=DUALDENS , MODEL=6 , DEVNO=(570,8) 
RDEVICE DEVTYPE=3420, FEATURE=DUALDENS , MODEL=6 , DEVNO=(670,8) 
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RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 


RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 


RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 


_ RDEVICE 
~ RDEVICE 


RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 


RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 


RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 


RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 


RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 


HCPRIO ASSEMBLE 


DEVTYPE=3420 , FEATURE=DUALDENS , MODEL=6 , DEVNO=(770,8) 
DEVTYPE=3420 , FEATURE=DUALDENS ,MODEL=6 , DEVNO=(870,8) 
DEVTYPE=3420 , FEATURE=DUALDENS , MODEL=6 , DEVNO=(970,8) 
DEVTYPE=3420, FEATURE=DUALDENS , MODEL=6 , DEVNO=(A70,8) 
DEVTYPE=3420, FEATURE=DUALDENS , MODEL=6 , DEVNO=(B70,8) 


DEVTYPE=3420 , FEATURE=DUALDENS , MODEL=6 , DEVNO=(080,8) 
DEVTYPE=3420 , FEATURE=DUALDENS , MODEL=6 , DEVNO=(180,8) 
DEVTYPE=3420, FEATURE=DUALDENS , MODEL=6 , DEVNO=(280,8) 
DEVTYPE=3420, FEATURE=DUALDENS , MODEL=6 , DEVNO=(380,8) 
DEVTYPE=3420 , FEATURE=DUALDENS , MODEL=6 , DEVNO=(480,8) 
DEVTYPE=3420, FEATURE=DUALDENS , MODEL=6 , DEVNO=(580, 8) 
DEVTYPE=3420 , FEATURE=DUALDENS , MODEL=6 , DEVNO=(680,8) 
DEVTYPE=3420 , FEATURE=DUALDENS , MODEL=6 , DEVNO=(780,8) 
DEVTYPE=3420 , FEATURE=DUALDENS ,MODEL=6 , DEVNO=(880,8) 
DEVTYPE=3420, FEATURE=DUALDENS ,MODEL=6 , DEVNO=(980,8) 
DEVTYPE=3420 , FEATURE=DUALDENS , MODEL=6,, DEVNO=(A80,8) 
DEVTYPE=3420, FEATURE=DUALDENS ,MODEL=6 , DEVNO=(B80,8) 


DEVTYPE=3330,MODEL=1 , DEVNO=(078,8) 
DEVTYPE=3330,MODEL=1,DEVNO=(178,8) 
DEVTYPE=3330,MODEL=1 , DEVNO=(278,8) 
DEVTYPE=3330 ,MODEL=1, DEVNO=(378,8) 
DEVTYPE=3330,MODEL=1 , DEVNO=(478,8) 
DEVTYPE=3330 ,MODEL=1 , DEVNO=(578,8) 


DEVTYPE=3330 ,MODEL=11,DEVNO=(050,8) 
DEVTYPE=3330,MODEL=11,DEVNO=(150,8) 
DEVTYPE=3330,MODEL=11,DEVNO=(250,8) 
DEVTYPE=3330 ,MODEL=11,DEVNO=(350,8) 
DEVTYPE=3330,MODEL=11,DEVNO=(450,8) 
DEVTYPE=3330,MODEL=11 , DEVNO=(550,8) 


DEVTYPE=3330,MODEL=11 , DEVNO=(058,8) 
DEVTYPE=3330,MODEL=11, DEVNO=(158,8) 
DEVTYPE=3330 ,MODEL=11 , DEVNO=(258,8) 
DEVTYPE=3330,MODEL=11, DEVNO=(358, 8) 
DEVTYPE=3330 ,MODEL=11, DEVNO=(458, 8) 
DEVTYPE=3330 ,MODEL=11,DEVNO=(558,8) 


DEVTYPE=3340 , DEVNO=(0CO, 8) 
DEVTYPE=3340 , DEVNO=(1C0,8) 
DEVTYPE=3340, DEVNO=(2C0, 8) 
DEVTYPE=3340 , DEVNO=(3C0,8) 
DEVTYPE=3340 , DEVNO=(4C0,8) 
DEVTYPE=3340, DEVNO=(5CO,8) 


DEVTYPE=3350 , DEVNO=(048, 8) 
DEVTYPE=3350, DEVNO=(148,8) 
DEVTYPE=3350 , DEVNO=(248, 8) 
DEVTYPE=3350 , DEVNO=(348, 8) 
DEVTYPE=3350 , DEVNO=(448, 8) 
DEVTYPE=3350 , DEVNO=(548, 8) 


DEVTYPE=3350 , DEVNO=(030, 8) 
DEVTYPE=3350, DEVNO=(130,8) 
DEVTYPE=3350 , DEVNO=(230, 8) 
DEVTYPE=3350, DEVNO=(330,8) 
DEVTYPE=3350 , DEVNO=(430, 8) 
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RDEVICE 


RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 


RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 


RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 


RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 


RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 


RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 


RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 


DEVTYPE=3350, DEVNO=(530,8) 


DEVTYPE=3350, DEVNO=(060, 8) 
DEVTYPE=3350 , DEVNO=(160,8) 
DEVTYPE=3350,, DEVNO=(260,8) 
DEVTYPE=3350 , DEVNO=(360,8) 
DEVTYPE=3350 , DEVNO=(460,8) 
DEVTYPE=3350 , DEVNO=(560,8) 


DEVTYPE=3375 , DEVNO=(090,8) 
DEVTYPE=3375 , DEVNO=(190,8) 
DEVTYPE=3375 , DEVNO=(290,8) 
DEVTYPE=3375 , DEVNO=(390,8) 
DEVTYPE=3375 , DEVNO=(490,8) 


DEVTY PE=3375, DEVNO=(068,8) 
DEVTYPE=3375 , DEVNO=(168,8) 
DEVTYPE=3375, DEVNO=(268, 8) 
DEVTYPE=3375 , DEVNO=(368, 8) 
DEVTY PE=3375 , DEVNO=(468,8) 
DEVTYPE=3375 , DEVNO=(568,8) 
DEVTYPE=3375 , DEVNO=(668,8) 


DEVTY PE=3380, DEVNO=(038,8) 
DEVTYPE=3380, DEVNO=(138,8) 
DEVTYPE=3380 , DEVNO=(238,8) 
DEVTYPE=3380 , DEVNO=(338,8) 
DEVTYPE=3380 , DEVNO=(438, 8) 
DEVTYPE=3380 , DEVNO=(538, 8) 
DEVTY PE=3380 , DEVNO=(638, 8) 


DEVTYPE=3380 , DEVNO=(OA0,8) 
DEVTYPE=3380 , DEVNO=(1A0,8) 
DEVTYPE=3380 , DEVNO=(2A0,8) 
DEVTYPE=3380 , DEVNO=(3A0,8) 
DEVTYPE=3380 , DEVNO=(4A0,8) 


DEVTYPE=2305,MODEL=2 , DEVNO=(OFO, 1) 
DEVTYPE=2305,MODEL=2 , DEVNO=(1F0, 1) 
DEVTYPE=2305 ,MODEL=2 , DEVNO=(2F0, 1) 
DEVTYPE=2305 ,MODEL=2 , DEVNO=(3F0, 1) 
DEVTYPE=2305 ,MODEL=2 , DEVNO=(4F0, 1) 
DEVTYPE=2305 ,MODEL=2 , DEVNO=(5FO, 1) 
DEVTYPE=2305 , MODEL=2 , DEVNO=(6FQ, 1) 
DEVTYPE=2305 ,MODEL=2 , DEVNO=(7F0,1) 
DEVTYPE=2305,MODEL=2 , DEVNO=(8FO, 1) 
DEVTYPE=2305 ,MODEL=2 , DEVNO=(9FO, 1) 
DEVTYPE=2305 ,MODEL=2 , DEVNO=(AFO, 1) 
DEVTYPE=2305 , MODEL=2 , DEVNO=(BFOQ, 1) 


DEVTYPE=2305 ,MODEL=2 , DEVNO=(0D0, 1) 
DEVTYPE=2305 ,MODEL=2 , DEVNO=(1D0, 1) 
DEVTYPE=2305 ,MODEL=2 , DEVNO=(2D0, 1) 
DEVTYPE=2305 ,MODEL=2 , DEVNO=(3D0, 1) 
DEVTYPE=2305,MODEL=2 , DEVNO=(4D0, 1) 
DEVTYPE=2305 ,MODEL=2 , DEVNO=(5D0, 1) 
DEVTYPE=2305 ,MODEL=2 , DEVNO=(6D0, 1) 
DEVTYPE=2305,MODEL=2 , DEVNO=(7D0, 1) 
DEVTYPE=2305 ,MODEL=2 , DEVNO=(8D0, 1) 
DEVTYPE=2305 ,MODEL=2 ,DEVNO=(9D0, 1) 
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RDEVICE DEVTYPE=2305 ,MODEL=2 , DEVNO=(ADO, 1) 
RDEVICE DEVTYPE=2305 ,MODEL=2 , DEVNO=(BDO, 1) 


* 


* 


RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 


RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 


RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 


RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 


DEVTYPE=3800 , DEVNO=(018,1) 
DEVTYPE=3800 , DEVNO=(118,1) 
DEVTYPE=3800 , DEVNO=(218, 1) 
DEVTY PE=3800 , DEVNO=(318, 1) 
DEVTYPE=3800 , DEVNO=(418, 1) 
DEVTYPE=3800 , DEVNO=(518, 1) 
DEVTYPE=3800 , DEVNO=(618, 1) 


DEVTYPE=3262 , DEVNO=(0A8, 1) 
DEVTYPE=3262 , DEVNO=(1A8, 1) 
DEVTYPE=3262 ,DEVNO=(2A8, 1) 
DEVTY PE=3262 , DEVNO=(3A8, 1) 
DEVTYPE=3262 , DEVNO=(4A8, 1) 
DEVTYPE=3262 , DEVNO=(5A8, 1) 


DEVTYPE=4245 , DEVNO=(0BO, 1) 
DEVTYPE=4245 , DEVNO=(1B0, 1) 
DEVTYPE=4245 , DEVNO=(2B0, 1) 
DEVTYPE=4245 , DEVNO=(3B0, 1) 
DEVTYPE=4245 , DEVNO=(4B0, 1) 
DEVTYPE=4245 , DEVNO=(5BOQ, 1) 


DEVTYPE=4248 , DEVNO=(0B8, 1) 
DEVTYPE=4248 , DEVNO=(1B8, 1) 
DEVTYPE=4248 , DEVNO=(2B8, 1) 
DEVTYPE=4248 , DEVNO=(3B8, 1) 
DEVTYPE=4248 , DEVNO=(4B8, 1) 
DEVTYPE=4248 , DEVNO=(5B8, 1) 


RDEVICE DEVTYPE=3278 ,MODEL=2 ,DEVNO=(020,8) 
RDEVICE DEVTYPE=3278,MODEL=2 ,DEVNO=(120,8) 
RDEVICE DEVTYPE=3278 ,MODEL=2 ,DEVNO=(220,8) 
RDEVICE DEVTYPE=3278,MODEL=2 ,DEVNO=(320,8) 
RDEVICE DEVTYPE=3278,MODEL=2 ,DEVNO=(420,8) 


* 


RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 


RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 


DEVTYPE=1403 ,DEVNO=(00E, 1) 
DEVTYPE=1403 ,DEVNO=(10E,1) 
DEVTYPE=1403 ,DEVNO=(20E, 1) 
DEVTYPE=1403 ,DEVNO=(30E, 1) 
DEVTYPE=1403 , DEVNO=(40E, 1) 
DEVTYPE=1403 , DEVNO=(50E, 1) 
DEVTYPE=1403 ,DEVNO=(60E, 1) 


DEVTYPE=1403 , DEVNO=(00F, 1) 
DEVTYPE=1403 ,DEVNO=(10F, 1) 
DEVTYPE=1403 ,DEVNO=(20F , 1) 
DEVTYPE=1403 , DEVNO=(30F , 1) 
DEVTYPE=1403 ,DEVNO=(40F ,1) 
DEVTYPE=1403 ,DEVNO=(50F , 1) 
DEVTYPE=1403 , DEVNO=(60F, 1) 


RDEVICE DEVTYPE=2540R, DEVNO=(00C, 1) 
RDEVICE DEVTYPE=2540R, DEVNO=(10C, 1) 
RDEVICE DEVTYPE=2540R, DEVNO=(20C, 1) 
RDEVICE DEVTYPE=2540R, DEVNO=(30C, 1) 
RDEVICE DEVTYPE=2540R, DEVNO=(40C, 1) 
RDEVICE DEVTYPE=2540R, DEVNO=(50C, 1) 
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RDEVICE 
* 

RDEVICE 

RDEVICE 

RDEVICE 

RDEVICE 

RDEVICE 

RDEVICE 

RDEVICE 
* 

RDEVICE 

RDEVICE 

RDEVICE 

RDEVICE 

RDEVICE 
* 

RDEVICE 

. RDEVICE 

( | RDEVICE 

_ RDEVICE 
* 

RDEVICE 

RDEVICE 

RDEVICE 

RDEVICE 

RDEVICE 

RDEVICE 

RDEVICE 


| ( . RDEVICE 
| 


RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 


RDEVICE 
RDEVICE 
uo RDEVICE 
( | RDEVICE 
. RDEVICE 
RDEVICE 
* 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
* 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 
RDEVICE 


ras RDEVICE 
( 7 RDEVICE 
~ RDEVICE 
RDEVICE 


DEVTYPE=2540R, DEVNO=(60C, 1) 


DEVTYPE=2540P,DEVNO=(00D, 1) 
DEVTYPE=2540P,DEVNO=(10D,1) 
DEVTYPE=2540P ,DEVNO=(20D, 1) 
DEVTYPE=2540P , DEVNO=(30D, 1) 
DEVTYPE=2540P,DEVNO=(40D, 1) 
DEVTYPE=2540P, DEVNO=(50D, 1) 
DEVTYPE=2540P ,DEVNO=(60D, 1) 


DEVTYPE=3211,DEVNO=(002, 1) 
DEVTYPE=3211,DEVNO=(102,1) 
DEVTYPE=3211,DEVNO=(202,1) 
DEVTYPE=3211, DEVNO=(302,1) 
DEVTYPE=3211,DEVNO=(402,1) 


DEVTYPE=3203 ,MODEL=5 , DEVNO=(003, 1) 


DEVTYPE=3203 ,MODEL=5 , DEVNO=(103,1) 


DEVTYPE=3203 ,MODEL=5 , DEVNO=(203, 1) 
DEVTYPE=3203 ,MODEL=5 , DEVNO=(303, 1) 


DEVTYPE=3278 , MODEL=2 , DEVNO=(040,8) 
DEVTYPE=3278 ,MODEL=2 , DEVNO=(140,8) 
DEVTYPE=3278 ,MODEL=2 , DEVNO=(240,8) 
DEVTYPE=3278 ,MODEL=2 , DEVNO=(340, 8) 
DEVTYPE=3278 ,MODEL=2 , DEVNO=(440,8) 
DEVTYPE=3278 ,MODEL=2 , DEVNO=(540,8) 
DEVTYPE=3278 ,MODEL=2 , DEVNO=(640, 8) 


DEVTYPE=3278 ,MODEL=5 , DEVNO= (088, 8) 
DEVTYPE=3278,MODEL=5 , DEVNO=(188, 8) 
DEVTYPE=3278,MODEL=5 , DEVNO=(288, 8) 
DEVTYPE=3278,MODEL=5 , DEVNO=(388, 8) 
DEVTYPE=3278 ,MODEL=5 ,DEVNO=(488, 8) 
DEVTYPE=3278,MODEL=5 , DEVNO=(588, 8) 


DEVTYPE=3290, DEVNO=(098,8) 
DEVTYPE=3290 , DEVNO=(198,8) 
DEVTYPE=3290 , DEVNO=(298,8) 
DEVTYPE=3290 , DEVNO=(398,8) 
DEVTYPE=3290 , DEVNO=(498,8) 
DEVTYPE=3290, DEVNO=(598,8) 


DEVTYPE=3505, CLASS=A, DEVNO=(012,1) 
DEVTYPE=3505, CLASS=A, DEVNO=(112, 1) 
DEVTYPE=3505, CLASS=A, DEVNO=(212,1) 
DEVTYPE=3505, CLASS=A, DEVNO=(312,1) 
DEVTYPE=3505 , CLASS=A, DEVNO=(412,1) 


DEVTYPE=3525, CLASS=A, DEVNO=(013,1) 
DEVTYPE=3525, CLASS=A, DEVNO=(113,1) 
DEVTYPE=3525 , CLASS=A, DEVNO=(213, 1) 
DEVTYPE=3525 , CLASS=A, DEVNO=(313, 1) 
DEVTYPE=3525, CLASS=A, DEVNO=(413,1) 


DEVTYPE=3480 , DEVNO=(004, 4) 
DEVTYPE=3480 , DEVNO=(104, 4) 
DEVTYPE=3480 , DEVNO=(204, 4) 
DEVTYPE=3480 , DEVNO=(304, 4) 
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RDEVICE DEVTYPE=3890 , DEVNO=(008, 4) 
RDEVICE DEVTYPE=3890 , DEVNO=(108, 4) 
* 

RDEVICE DEVTYPE=HFGD,DEVNO=(014,4) 
RDEVICE DEVTYPE=HFGD, DEVNO=(114,4) 


* 


EJECT 


KKK II KIKI KR ERI KIRKE IRIE RIKER RE REAR ARERRRERERE 


SPACE 2 
RIOGEN CONS=020,ALTCONS=(120,220,320, . 
420,040, 140,240,340, 440,540,640) 


ages 
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IOCP 


Sample Input/Output Configuration Profile 


IBM supplies the following sample file with VM/XA SP. It is only a sample file, and must be tailored to 
your installation before it can be used. 


KKKIKKKKKKKEKREKRKEKREREREREKRKE RE RKEKREREREERERERREREREKRREERERERKEKSE 


xe Virtual Machine / System Product 5664-308 one 
“ee Contains restricted materials of IBM nee 
al Copyright (c) I BM Corporation 1988 eee 
iis Licensed Materials - Property of IBM ie 


es Refer to Copyright Instructions: Form G120-2083 *** 
KHKAKKKKKKKKEKKEKKEKEKRKEKEKRKEK ERE KKRERE KE REREKREEREREKREERERREEERER 
ID MSG1='SAMPLE IOCP INPUT FILE’, . 
MSG2='COMPANION TO SAMPLE HCPRIO' 
CHPID PATH=((00,0,0),(01,1,0),(02,2,0),(03,3,0),(04,4,0),(05,5,0), . 
(06,6,0),(07,7,0)) ,TYPE=BL 
— CHPID PATH=((10,8,0),(11,9,0),(12,A,0),(13,B,0)) ,TYPE=BL 
( . CHPID PATH=((14,0,1),(15,1,1),(16,2,1),(17,3,1),(20,4,1),(21,5,1), . 
. (22,6,1),(23,7,1)), TYPE=BL 
CHPID PATH=((24,8,1),(25,9,1) ,(26,A,1) ,(27,B,1)) , TYPE=BL 


*TOCP 
CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


*TOCP 
CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CUNUMBR=001 , UNIT=3803 , UNI TADD=((70,8)), 
PATH=(00, 14) , PROTOCL=D, SHARED=Y 
CUNUMBR=002 , UNIT=3803 , UNITADD=((70,8)), 
PATH=(01,15) , PROTOCL=D , SHARED=Y 
CUNUMBR=003 , UNI T=3803, UNI TADD=((70,8)), 
PATH=(02,16) , PROTOCL=D , SHARED=Y 
CUNUMBR=004 , UNIT=3803 , UNITADD=((70,8)), 
PATH=(03,17) , PROTOCL=D, SHARED=Y 
CUNUMBR=005 , UNIT=3803 , UNITADD=((70,8)), 
PATH=(04,20) , PROTOCL=D , SHARED=Y 
CUNUMBR=006 , UNIT=3803 , UNITADD=((70,8)), 
PATH=(05,21) , PROTOCL=D, SHARED=Y 
CUNUMBR=007 , UNIT=3803 , UNITADD=((70,8)), 
PATH=(06,22) , PROTOCL=D,, SHARED=Y 
CUNUMBR=008 , UNIT=3803 , UNITADD=((70,8)), 
PATH=(07,23) ,PROTOCL=D ,, SHARED=Y 
CUNUMBR=009 , UNIT=3803 , UNITADD=((70,8)), 
PATH=(10,24) , PROTOCL=D, SHARED=Y 
CUNUMBR=00A, UNI T=3803 , UNITADD=((70,8)), 
PATH=(11,25) , PROTOCL=D, SHARED=Y 
CUNUMBR=06B , UNIT=3803 , UNITADD=((70,8)), 
PATH=(12,26) , PROTOCL=D, SHARED=Y 
CUNUMBR=00C , UNI T=3803 , UNITADD=((70,8)), 
PATH=(13,27) , PROTOCL=D, SHARED=Y 


CUNUMBR=00D , UNIT=3803 , UNITADD=((80,8)), 
PATH=(00, 14) , PROTOCL=D, SHARED=Y 
CUNUMBR=00E , UNIT=3803, UNITADD=( (80,8) ), 
PATH=(@1,15) , PROTOCL=D, SHARED=Y 
CUNUMBR=00F , UNIT=3803 , UNITADD=((80,8)), 
PATH=(@2,16) , PROTOCL=D, SHARED=Y 
CUNUMBR=010 , UNIT=3803 , UNI TADD=((80,8)), 
PATH=(03,17) , PROTOCL=D, SHARED=Y 
CUNUMBR=011, UNIT=3803 , UNI TADD=( (80,8) ), 
PATH=(04,20) , PROTOCL=D, SHARED=Y 
CUNUMBR=012 , UNIT=3803 , UNI TADD=( (80,8) ), 
PATH=(05,21) , PROTOCL=D, SHARED=Y 
CUNUMBR=013 , UNIT=3803 , UNI TADD=( (80,8) ) , 
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IOCP 


CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 


CNTLUNIT 


* 


CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
_ CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 


CNTLUNIT 


* 


CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 


CNTLUNIT 


PATH=(06,22) , PROTOCL=D,, SHARED=Y 
CUNUMBR=014 , UNIT=3803 , UNITADD=((80,8)), 
PATH=(07,23) , PROTOCL=D,, SHARED=Y 
CUNUMBR=015 , UNIT=3803 , UNITADD=((80,8)), 
PATH=(10,24) , PROTOCL=D, SHARED=Y 
CUNUMBR=016 , UNIT=3803 , UNITADD=( (80,8) ), 
PATH=(11,25) , PROTOCL=D, SHARED=Y 
CUNUMBR=017 , UNIT=3803 , UNITADD=( (80,8) ), 
PATH=(12,26) , PROTOCL=D, SHARED=Y 
CUNUMBR=018 , UNIT=3803 , UNITADD=( (80,8) ) , 
PATH=(13,27) , PROTOCL=D, SHARED=Y 


CUNUMBR=019 , UNIT=3830 , UNITADD=((50,8)), 
PATH=(00, 14) , PROTOCL=D, SHARED=N 
CUNUMBR=01A, UNI T=3830, UNI TADD=( (50,8) ) , 
PATH=(01,15) ,PROTOCL=D, SHARED=N 
CUNUMBR=01B , UNIT=3830, UNITADD=((50,8)), 
PATH=(02, 16) , PROTOCL=D, SHARED=N 
CUNUMBR=01C , UNIT=3830 , UNI TADD=( (50,8) ), 
PATH=(03,17) , PROTOCL=D, SHARED=N 
CUNUMBR=01D, UNIT=3830, UNITADD=( (50,8) ), 
PATH=(04,20) , PROTOCL=D, SHARED=N 
CUNUMBR=01E , UNIT=3830, UNITADD=((50,8)), 
PATH=(05,21) , PROTOCL=D , SHARED=N 
CUNUMBR=01F , UNIT=3830 , UNITADD=( (50,8) ), 
PATH=(06,22) , PROTOCL=D, SHARED=N 
CUNUMBR=020 , UNIT=3830, UNI TADD=( (50,8) ), 
PATH=(07,23) , PROTOCL=D, SHARED=N 
CUNUMBR=021 , UNIT=3830, UNITADD=((50,8)), 
PATH=(10,24) , PROTOCL=D, SHARED=N 
CUNUMBR=022 , UNIT=3830 , UNITADD=((50,8)) , 
PATH=(11,25) , PROTOCL=D, SHARED=N 
CUNUMBR=023 , UNIT=3830, UNITADD=( (50,8) ), 
PATH=(12,26) , PROTOCL=D, SHARED=N 
CUNUMBR=024 , UNIT=3830, UNI TADD=( (50,8)), 
PATH=(13,27) , PROTOCL=D, SHARED=N 


CUNUMBR=025 , UNIT=3830, UNITADD=((58,8)), 
PATH=(00, 14) , PROTOCL=D, SHARED=N 
CUNUMBR=026 , UNIT=3830, UNITADD=((58,8)), 
PATH=(01,15) , PROTOCL=D, SHARED=N 
CUNUMBR=027 , UNIT=3830, UNI TADD=( (58,8) ), 
PATH=(02,16) , PROTOCL=D, SHARED=N 
CUNUMBR=028,, UNIT=3830, UNI TADD=((58,8)), 
PATH=(03,17) , PROTOCL=D, SHARED=N 
CUNUMBR=029 , UNIT=3830, UNI TADD=((58,8)) , 
PATH=(04,20) , PROTOCL=D, SHARED=N 
CUNUMBR=02A,, UNIT=3830 , UNITADD=( (58,8) ), 
PATH=(05,21) ,PROTOCL=D,, SHARED=N 
CUNUMBR=02B, UNI T=3830, UNI TADD=((58,8)), 
PATH=(06,22) , PROTOCL=D,, SHARED=N 
CUNUMBR=02C , UNIT=3830 , UNITADD=((58,8)), 
PATH=(07 ,23) , PROTOCL=D, SHARED=N 
CUNUMBR=02D , UNI T=3830, UNI TADD=( (58,8) ), 
PATH=(10,24) , PROTOCL=D, SHARED=N 
CUNUMBR=02E , UNIT=3830, UNITADD=((58,8)), 
PATH=(11,25) , PROTOCL=D, SHARED=N 
CUNUMBR=02F , UNI T=3830, UNI TADD=((58,8)), 
PATH=(12,26) , PROTOCL=D, SHARED=N 
CUNUMBR=030 , UNI T=3830, UNI TADD=( (58,8) ), 
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CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


CNTLUNIT 


aL DO 0 5 DORE EEE RESO TOOT OT 


PATH=(13,27) , PROTOCL=D, SHARED=N 


CUNUMBR=031, UNIT=3830, UNITADD=((CO,8)), 
PATH=(00, 14) , PROTOCL=D , SHARED=N 
CUNUMBR=032 , UNIT=3830, UNITADD=((CO,8)), 
PATH=(01,15) , PROTOCL=D, SHARED=N 
CUNUMBR=033 , UNIT=3830, UNI TADD=((CO,8)), 
PATH=(02,16) , PROTOCL=D, SHARED=N 
CUNUMBR=034 , UNIT=3830 , UNITADD=((CO,8)), 
PATH=(03,17) , PROTOCL=D, SHARED=N 
CUNUMBR=035 , UNIT=3830, UNITADD=((CO,8)), 
PATH=(04,20) , PROTOCL=D, SHARED=N 
CUNUMBR=036 , UNIT=3830, UNI TADD=((CO,8)), 
PATH=(05,21) , PROTOCL=D, SHARED=N 
CUNUMBR=037 , UNIT=3830, UNITADD=((CO,8)), 
PATH=(06,22) , PROTOCL=D, SHARED=N 
CUNUMBR=038 , UNIT=3830,UNITADD=((CO,8)), 
PATH=(07,23) , PROTOCL=D, SHARED=N 
CUNUMBR=039 , UNIT=3830, UNI TADD=((CO,8)), 
PATH=(10,24) , PROTOCL=D, SHARED=N 
CUNUMBR=03A, UNIT=3830, UNITADD=((CO,8)), 
PATH=(11,25) , PROTOCL=D, SHARED=N 
CUNUMBR=03B, UNIT=3830,, UNI TADD=((CO,8)), 
PATH=(12,26) , PROTOCL=D, SHARED=N 
CUNUMBR=03C , UNIT=3830, UNI TADD=((CO,8) ) , 
PATH=(13,27) , PROTOCL=D, SHARED=N 


CUNUMBR=03D , UNIT=3830, UNITADD=( (48,8) ), 
PATH=(00, 14) , PROTOCL=D, SHARED=N 
CUNUMBR=03E , UNIT=3830, UNITADD=( (48,8) ) , 
PATH=(01,15) ,PROTOCL=D, SHARED=N 
CUNUMBR=03F , UNIT=3830, UNI TADD=( (48,8) ), 
PATH=(02, 16) , PROTOCL=D, SHARED=N 
CUNUMBR=040 , UNIT=3830, UNITADD=( (48,8) ), 
PATH=(03,17) , PROTOCL=D , SHARED=N 
CUNUMBR=041 , UNIT=3830 , UNITADD=( (48,8) ), 
PATH=(04,20) , PROTOCL=D, SHARED=N 
CUNUMBR=042 , UNIT=3830 , UNITADD=((48,8)), 
PATH=(05,21) ,PROTOCL=D, SHARED=N 
CUNUMBR=043 , UNIT=3830, UNITADD=( (48,8) ), 
PATH=(06,22) , PROTOCL=D, SHARED=N 
CUNUMBR=044 , UNIT=3830, UNITADD=( (48,8) ), 
PATH=(07,23) , PROTOCL=D, SHARED=N 
CUNUMBR=045 , UNIT=3830, UNITADD=( (48,8) ), 
PATH=(10,24) , PROTOCL=D, SHARED=N 
CUNUMBR=046 , UNIT=3830, UNI TADD=( (48,8) ), 
PATH=(11,25) , PROTOCL=D, SHARED=N 
CUNUMBR=047 , UNIT=3830, UNITADD=( (48,8) ), 
PATH=(12,26) , PROTOCL=D, SHARED=N 
CUNUMBR=048, UNI T=3830, UNITADD=((48,8)), 
PATH=(13,27) ,PROTOCL=D, SHARED=N 


CUNUMBR=049 , UNIT=3830, UNITADD=( (30,8) ), 
PATH=(00,14) , PROTOCL=D, SHARED=N 
CUNUMBR=04A , UNIT=3830, UNITADD=( (30,8) ), 
PATH=(01,15) , PROTOCL=D, SHARED=N 
CUNUMBR=04B, UNIT=3830, UNI TADD=((30,8)), 
PATH=(02,16) ,PROTOCL=D, SHARED=N 
CUNUMBR=04C , UNIT=3830, UNITADD=((30,8)), 
PATH=(03,17) , PROTOCL=D, SHARED=N 
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7358 


IOCP 


CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 


CNTLUNIT 


CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 


CNTLUNIT 


CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 
CNTLUNIT 


CNTLUNIT 


CUNUMBR=04D , UNIT=3830, UNITADD=( (30,8) ), 
PATH=(04,20) , PROTOCL=D, SHARED=N 
CUNUMBR=04E , UNIT=3830, UNITADD=( (30,8) ), 
PATH=(05,21) , PROTOCL=D, SHARED=N 
CUNUMBR=04F , UNIT=3830, UNI TADD=((30,8)), 
PATH=(06,22) , PROTOCL=D, SHARED=N 
CUNUMBR=050 , UNIT=3830, UNITADD=((30,8)), 
PATH=(07 ,23) , PROTOCL=D, SHARED=N 
CUNUMBR=051 , UNIT=3830, UNITADD=( (30,8) ), 
PATH=(10,24) , PROTOCL=D , SHARED=N 
CUNUMBR=052 , UNIT=3830, UNITADD=( (30,8) ), 
PATH=(11,25) , PROTOCL=D, SHARED=N 
CUNUMBR=053 , UNIT=3830 , UNITADD=( (30,8) ) , 
| PATH=(12,26) , PROTOCL=D , SHARED=N 
CUNUMBR=054 , UNIT=3830, UNITADD=( (30,8) ), 
PATH=(13,27) , PROTOCL=D, SHARED=N 


CUNUMBR=055 , UNIT=3880, UNITADD=( (60,8) ) , 
PATH=(00, 14) , PROTOCL=D, SHARED=N 
CUNUMBR=056 , UNI T=3880 , UNI TADD=( (60,8) ) , 
PATH=(01,15) , PROTOCL=D,, SHARED=N 
CUNUMBR=057 , UNIT=3880, UNITADD=( (60,8) ), 
PATH=(02,16) , PROTOCL=D,, SHARED=N 
CUNUMBR=058 , UNIT=3880 , UNITADD=( (60,8) ), 
PATH=(03,17) , PROTOCL=D, SHARED=N 
CUNUMBR=059 , UNIT=3880 , UNITADD=( (60,8) ), 
PATH=(04,20) , PROTOCL=D , SHARED=N 
CUNUMBR=05A , UNIT=3880 , UNI TADD=( (60,8) ), 
PATH=(05,21) , PROTOCL=D, SHARED=N 
CUNUMBR=05B, UNI T=3880, UNITADD=( (60,8) ), 
PATH=(06,22) , PROTOCL=D,, SHARED=N 
CUNUMBR=05C , UNIT=3880 , UNITADD=( (60,8) ), 
PATH=(07,23) , PROTOCL=D, SHARED=N 
CUNUMBR=05D , UNIT=3880 , UNITADD=( (60,8) ), 
PATH=(10,24) , PROTOCL=D, SHARED=N 
CUNUMBR=05E , UNIT=3880, UNITADD=( (60,8) ), 
PATH=(11,25) , PROTOCL=D , SHARED=N 
CUNUMBR=05F , UNIT=3880, UNI TADD=((60,8)), 
PATH=(12,26) , PROTOCL=D, SHARED=N 
CUNUMBR=060 , UNI T=3880, UNITADD=((60,8)), 
| PATH=(13,27) , PROTOCL=D, SHARED=N 


CUNUMBR=061 , UNIT=2835, UNITADD=((FO,8)), 
PATH=(00, 14) , PROTOCL=D,, SHARED=N 
CUNUMBR=062 , UNIT=2835, UNITADD=((FO,8)), 
PATH=(01,15) , PROTOCL=D, SHARED=N 
CUNUMBR=063 , UNIT=2835, UNITADD=((FO,8)), 
PATH=(02,16) , PROTOCL=D, SHARED=N 
CUNUMBR=064 , UNIT=2835, UNI TADD=((FO,8)), 
PATH=(03,17) , PROTOCL=D, SHARED=N 
CUNUMBR=065 , UNIT=2835, UNITADD=((FO,8)), 
PATH=(04,20) , PROTOCL=D,, SHARED=N 
CUNUMBR=066 , UNIT=2835 ,UNITADD=((FO,8)), 
PATH=(05,21) , PROTOCL=D, SHARED=N 
CUNUMBR=067 , UNIT=2835, UNITADD=((FO,8)), 
PATH=(06,22) , PROTOCL=D, SHARED=N 
CUNUMBR=068 , UNIT=2835 ,UNITADD=((FO,8)), 
~ PATH=(07,23) , PROTOCL=D, SHARED=N 
CUNUMBR=069 , UNIT=2835, UNI TADD=((FO,8)), 
PATH=(10,24) , PROTOCL=D, SHARED=N 


Installation and Service 


i ce 


IOCP 


CNTLUNIT CUNUMBR=06A,UNIT=2835,UNITADD=((FO,8)), * 
PATH=(11,25) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=06B,UNIT=2835 ,UNITADD=((FO,8)), * 
PATH=(12,26) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=06C ,UNIT=2835,UNITADD=((FO,8)), * 
PATH=(13,27) , PROTOCL=D, SHARED=N 
* 
CNTLUNIT CUNUMBR=06D,UNIT=2835,UNITADD=((DO,8)), * 
PATH=(00,14) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=06E ,UNIT=2835,UNITADD=((D0,8)), * 
PATH=(01,15) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=06F ,UNIT=2835 , UNITADD=((DO,8)) , * 
PATH=(02,16) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=070,UNIT=2835 , UNITADD=((D0,8)), * 
PATH=(03,17) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=071,UNIT=2835 , UNITADD=((DO,8)) , * 
PATH=(04,20) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=072,UNIT=2835 , UNITADD=((D0,8)) , * 
: 7 PATH=(05,21) , PROTOCL=D, SHARED=N 
( | CNTLUNIT CUNUMBR=073,UNIT=2835,UNITADD=((D0,8)), * 
PATH=(06,22) ,PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=074 ,UNIT=2835,UNITADD=((D0,8)), * 
PATH=(07,23) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=075 ,UNIT=2835,UNITADD=((DO,8)), * 
PATH=(10,24) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=076,UNIT=2835,UNITADD=((D0,8)), * 
PATH=(11,25) , PROTOCL=D, SHARED=N : 
CNTLUNIT CUNUMBR=077 ,UNIT=2835,UNITADD=((DO,8)), * 
_ PATH=(12,26) , PROTOCL=D, SHARED=N 
( “ CNTLUNIT CUNUMBR=078,UNIT=2835,UNITADD=((D0,8)), * 
: PATH=(13,27) , PROTOCL=D, SHARED=N 
* 
CNTLUNIT CUNUMBR=079 ,UNIT=3800 ,UNITADD=((18,1)), * 
PATH=(00,14) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=07A,UNIT=3800,UNITADD=((18,1)), * 
PATH=(01,15) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=07B,UNIT=3800,UNITADD=((18,1)), * 
PATH=(02,16) , PROTOCL=D, SHARED=N | 
CNTLUNIT CUNUMBR=07C,UNIT=3800,UNITADD=((18,1)), * 
ioe PATH=(03,17) , PROTOCL=D, SHARED=N 
( CNTLUNIT CUNUMBR=07D,UNIT=3800 , UNITADD=((18,1)), * 
PATH=(04,20) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=07E ,UNIT=3800,UNITADD=((18,1)), * 
PATH=(05,21) , PROTOCL=D, SHARED=N 
CNTLUNIT CUNUMBR=07F ,UNIT=3800,UNITADD=((18,1)), * 
PATH=(06,22) , PROTOCL=D, SHARED=N 
* 
CNTLUNIT CUNUMBR=080,UNIT=3274, UNITADD=((20,8)), * 
PATH=(07,23) , PROTOCL=D, SHARED=Y 
CNTLUNIT CUNUMBR=081 ,UNIT=3274 , UNITADD=((20,8)), * 
PATH=(10,24) , PROTOCL=D, SHARED=Y 
CNTLUNIT CUNUMBR=082 ,UNIT=3274 , UNITADD=((20,8)), * 
PATH=(11,25) , PROTOCL=D, SHARED=Y 
CNTLUNIT CUNUMBR=083 ,UNIT=3274,UNITADD=((20,8)), * 
PATH=(12,26) , PROTOCL=D, SHARED=Y 
CNTLUNIT CUNUMBR=084 , UNIT=3274, UNITADD=((20,8)) , * 


PATH=(13,27) , PROTOCL=D,, SHARED=Y 


* 


CNTLUNIT CUNUMBR=085 , UNIT=2821,UNITADD=((0C,4)), e 
PATH=(00,14) , PROTOCL=D , SHARED=N 
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CUNUMBR=086 , UNIT=2821, UNITADD=((0C,4)), 
PATH=(01,15) , PROTOCL=D, SHARED=N 
CUNUMBR=087 , UNIT=2821 ,UNITADD=((0C,4)), 
PATH=(02,16) , PROTOCL=D, SHARED=N 
CUNUMBR=088 , UNIT=2821 ,UNITADD=((0C,4)), 
PATH=(03,17) , PROTOCL=D, SHARED=N 
CUNUMBR=089 , UNIT=2821 , UNITADD=((0C,4)), 
| PATH=(04,20) , PROTOCL=D, SHARED=N 
CUNUMBR=08A , UNIT=2821, UNITADD=((0C,4)), 
PATH=(05,21) , PROTOCL=D, SHARED=N 
CUNUMBR=08B , UNIT=2821,UNITADD=((0C,4)), 
PATH=(06, 22) , PROTOCL=D, SHARED=N 


CUNUMBR=08C , UNIT=3811,UNITADD=((02,1)), 
PATH=(Q7,23) , PROTOCL=D, SHARED=N 
CUNUMBR=08D , UNIT=3811, UNITADD=((02,1)), 
PATH=(10,24) , PROTOCL=D, SHARED=N 
CUNUMBR=08E , UNIT=3811,UNITADD=((02,1)), 
PATH=(11,25) , PROTOCL=D, SHARED=N 
CUNUMBR=08F , UNIT=3811, UNITADD=((02,1)), 
PATH=(12,26) , PROTOCL=D, SHARED=N 
CUNUMBR=090 , UNIT=3811, UNITADD=((02,1)), 
PATH=(13,27) , PROTOCL=D, SHARED=N 


CUNUMBR=091 , UNIT=3274, UNITADD=( (40,8) ), 
PATH=(00, 14) , PROTOCL=D, SHARED=Y 
CUNUMBR=092 , UNIT=3274, UNITADD=((40,8)), 
PATH=(01,15) , PROTOCL=D, SHARED=Y 
CUNUMBR=093 , UNIT=3274, UNI TADD=( (40,8) ), 
PATH=(02,16) , PROTOCL=D, SHARED=Y 
CUNUMBR=094 , UNIT=3274, UNI TADD=((40,8)), 
PATH=(03,17) , PROTOCL=D, SHARED=Y 
CUNUMBR=095 , UNIT=3274, UNITADD=((40,8)), 
PATH=(04,20) , PROTOCL=D, SHARED=Y 
CUNUMBR=096 , UNIT=3274, UNI TADD=((40,8)), 
PATH=(05,21) , PROTOCL=D, SHARED=Y 
CUNUMBR=097 , UNIT=3274, UNI TADD=((40,8)), 
PATH=(06,22) , PROTOCL=D, SHARED=Y 


CUNUMBR=098,, UNIT=3505, UNITADD=((12,2)), 
PATH=(07,23) , PROTOCL=D, SHARED=N 
CUNUMBR=099 , UNIT=3505, UNITADD=((12,2)), 
PATH=(10,24) , PROTOCL=D, SHARED=N 
CUNUMBR=09A, UNIT=3505,UNITADD=((12,2)), 
PATH=(11,25) , PROTOCL=D, SHARED=N 
CUNUMBR=09B , UNIT=3505, UNITADD=((12,2)), 
PATH=(12,26) , PROTOCL=D, SHARED=N 
CUNUMBR=09C , UNIT=3505, UNITADD=((12,2)), 
PATH=(13,27) , PROTOCL=D, SHARED=N 


CUNUMBR=09D , UNIT=3880, UNITADD=((68,8)), 
PATH=(00,14) , PROTOCL=D, SHARED=N 
CUNUMBR=09E , UNIT=3880, UNITADD=((68,8)), 
PATH=(01,15) , PROTOCL=D, SHARED=N 
CUNUMBR=09F , UNIT=3880 , UNITADD=( (68,8) ) , 
PATH=(02, 16) , PROTOCL=D, SHARED=N 
CUNUMBR=0A0 , UNIT=3880 , UNI TADD=( (68,8) ), 
PATH=(03,17) , PROTOCL=D, SHARED=N 
CUNUMBR=0A1 , UNI T=3880, UNI TADD=( (68,8) ), 
PATH=(04,20) , PROTOCL=D, SHARED=N 
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CUNUMBR=0A2 , UNI T=3880 , UNITADD=( (68,8) ) , 
PATH=(05,21) , PROTOCL=D, SHARED=N 

CUNUMBR=0A3 , UNIT=3880 , UNI TADD=((68,8)), 
PATH=(06,22) , PROTOCL=D, SHARED=N 


CUNUMBR=0A4 , UNIT=3880 , UNITADD=((90,8)) , 
PATH=(07,23) , PROTOCL=D, SHARED=N 
CUNUMBR=0A5 , UNIT=3880 , UNITADD=((90,8)), 
PATH=(10,24) , PROTOCL=D, SHARED=N 
CUNUMBR=0A6 , UNIT=3880,, UNITADD=((90,8)), 
PATH=(11,25) , PROTOCL=D, SHARED=N 
CUNUMBR=0A7 , UNIT=3880 , UNITADD=( (90,8) ), 
PATH=(12,26) , PROTOCL=D, SHARED=N 
CUNUMBR=0A8 , UNIT=3880, UNI TADD=( (90,8) ), 
PATH=(13,27) , PROTOCL=D, SHARED=N 


CUNUMBR=0A9 , UNIT=3880 , UNITADD=( (38,8) ) , 
PATH=(00,14) , PROTOCL=D, SHARED=N 
CUNUMBR=0AA , UNI T=3880, UNI TADD=((38,8)), 
PATH=(01,15) ,PROTOCL=D, SHARED=N 
CUNUMBR=0AB , UNIT=3880 , UNI TADD=( (38,8) ), 
PATH=(02,16) ,PROTOCL=D, SHARED=N 
CUNUMBR=0AC , UNIT=3880 , UNITADD=( (38,8) ), 
PATH=(03,17) , PROTOCL=D, SHARED=N 
CUNUMBR=0AD , UNI T=3880 , UNITADD=( (38,8) ), 
PATH=(04, 20) , PROTOCL=D, SHARED=N 
CUNUMBR=0AE , UNIT=3880 , UNI TADD=( (38,8) ), 
PATH=(05,21) , PROTOCL=D, SHARED=N 
CUNUMBR=0AF , UNIT=3880 , UNI TADD=( (38,8) ), 
PATH=(06,22) , PROTOCL=D, SHARED=N 


CUNUMBR=0B0 , UNIT=3880 , UNITADD=((AQ,8)), 
PATH=(07,23) , PROTOCL=D, SHARED=N 
CUNUMBR=0B1 , UNIT=3880, UNI TADD=((A0,8)), 
PATH=(10,24) , PROTOCL=D, SHARED=N 
CUNUMBR=0B2 , UNI T=3880 , UNITADD=((A0,8)) , 
PATH=(11,25) , PROTOCL=D , SHARED=N 
CUNUMBR=0B3 , UNIT=3880 , UNITADD=((A0,8) ) , 
PATH=(12,26) , PROTOCL=D, SHARED=N 
CUNUMBR=0B4 , UNIT=3880 , UNI TADD=((A0,8) ), 
PATH=(13,27) ,PROTOCL=D, SHARED=N 


CUNUMBR=0B5 , UNIT=3203 ,UNITADD=((03,1)), 
PATH=(00, 14) , PROTOCL=D, SHARED=N 
CUNUMBR=0B6 , UNIT=3203 , UNITADD=((03,1)), 
PATH=(01,15) , PROTOCL=D , SHARED=N 
CUNUMBR=0B7 , UNIT=3203 , UNITADD=((03,1)), 
PATH=(02,16) , PROTOCL=D, SHARED=N 
CUNUMBR=0B8 , UNIT=3203 , UNITADD=((03,1)), 
PATH=(03,17) ,PROTOCL=D, SHARED=N 


CUNUMBR=0B9 , UNIT=3480, UNITADD=((04,4)), 
PATH=(04,20) , PROTOCL=S , SHARED=N 
CUNUMBR=O0BA, UNI T=3480, UNITADD=((04,4)), 
PATH=(05,21) , PROTOCL=S , SHARED=N 
CUNUMBR=OBB ,, UNIT=3480, UNI TADD=((04,4)), 
PATH=(06,22) , PROTOCL=S , SHARED=N 
CUNUMBR=0BC , UNIT=3480, UNITADD=((04,4)), 
PATH=(07,23) ,PROTOCL=S , SHARED=N 
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CUNUMBR=OBD , UNIT=3890 , UNITADD=( (08,4) ) , 
PATH=(10,24) , PROTOCL=D, SHARED=N 

CUNUMBR=OBE , UNIT=3890 , UNI TADD=( (08,4) ), 
PATH=(11,25) , PROTOCL=D, SHARED=N 


CUNUMBR=OBF , UNIT=5088, UNITADD=((14,4)), 
PATH=(12,26) , PROTOCL=D, SHARED=N 

CUNUMBR=0C0 , UNIT=5088 , UNITADD=((14,4)), 
PATH=(13,27) ,PROTOCL=D, SHARED=N 


CUNUMBR=001 , UNIT=3420 , ADDRESS=(070,8) 
CUNUMBR=002 , UNIT=3420, ADDRESS=(170,8) 
CUNUMBR=003 , UNIT=3420, ADDRESS=(270,8) 
CUNUMBR=004 , UNIT=3420 , ADDRESS=(370,8) 
CUNUMBR=005 , UNIT=3420, ADDRESS=(470,8) 
CUNUMBR=006 , UNIT=3420, ADDRESS=(570,8) 
CUNUMBR=007 , UNIT=3420, ADDRESS=(670,8) 
CUNUMBR=008 , UNI T=3420 , ADDRESS=(770,8) 
CUNUMBR=009 , UNIT=3420 , ADDRESS=(870,8) 
CUNUMBR=00A , UNIT=3420 , ADDRESS=(970,8) 
CUNUMBR=00B , UNIT=3420, ADDRESS=(A70,8) 
CUNUMBR=00C , UNI T=3420 , ADDRESS=(B70,8) 


CUNUMBR=00D , UNIT=3420 , ADDRESS=(080,8) 
CUNUMBR=Q0E , UNIT=3420, ADDRESS=(180,8) 
CUNUMBR=00F , UNI T=3420 , ADDRESS=(280,8) 
CUNUMBR=010, UNIT=3420, ADDRESS=(380,8) 
CUNUMBR=011, UNIT=3420, ADDRESS=(480,8) 
CUNUMBR=012 , UNIT=3420, ADDRESS=(580,8) 
CUNUMBR=013 , UNIT=3420, ADDRESS=(680,8) 
CUNUMBR=014 , UNIT=3420, ADDRESS=(780,8) 
CUNUMBR=015 , UNIT=3420, ADDRESS=(880,8) 
CUNUMBR=016, UNIT=3420, ADDRESS=(980,8) 
CUNUMBR=017 , UNIT=3420, ADDRESS=(A80,8) 
CUNUMBR=018 , UNIT=3420, ADDRESS=(B80,8) 


CUNUMBR=019 , UNI T=3330, ADDRESS=(050,8) 
CUNUMBR=01A, UNI T=3330, ADDRESS=(150,8) 
CUNUMBR=01B, UNIT=3330, ADDRESS=(250,8) 
CUNUMBR=01C , UNIT=3330, ADDRESS=(350,8) 
CUNUMBR=01D, UNIT=3330, ADDRESS=(450,8) 
CUNUMBR=01E , UNIT=3330, ADDRESS=(550,8) 
CUNUMBR=01F , UNIT=3330, ADDRESS=(650,8) 
CUNUMBR=020,, UNIT=3330, ADDRESS=(750,8) 
CUNUMBR=021 , UNIT=3330, ADDRESS=(850,8) 
CUNUMBR=022 , UNIT=3330, ADDRESS=(950,8) 
CUNUMBR=023 , UNIT=3330, ADDRESS=(A50,8) 
CUNUMBR=024 , UNI T=3330, ADDRESS=(B50,8) 


CUNUMBR=025 , UNI T=3330, ADDRESS=(058,8) 
CUNUMBR=026 , UNI T=3330, ADDRESS=(158,8) 
CUNUMBR=027 , UNIT=3330, ADDRESS=(258, 8) 
CUNUMBR=028 , UNIT=3330, ADDRESS=(358,8) 
CUNUMBR=029 , UNI T=3330, ADDRESS=(458,8) 
CUNUMBR=02A , UNIT=3330, ADDRESS=(558, 8) 
CUNUMBR=02B , UNI T=3330, ADDRESS=(658,8) 
CUNUMBR=02C , UNIT=3330, ADDRESS=(758,8) 
CUNUMBR=02D , UNIT=3330, ADDRESS=(858,8) 
CUNUMBR=02E , UNI T=3330, ADDRESS=(958,8) 
CUNUMBR=02F , UNIT=3330, ADDRESS=(A58,8) 
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CUNUMBR=030 , UNIT=3330, ADDRESS= (B58, 8) 


CUNUMBR=031, UNIT=3340, ADDRESS=(0CO,8) 
CUNUMBR=032 , UNIT=3340, ADDRESS=(1C0,8) 
CUNUMBR=033 , UNI T=3340, ADDRESS=(2C0,8) 
CUNUMBR=034, UNI T=3340 , ADDRESS=(3C0,8) 
CUNUMBR=035 , UNIT=3340, ADDRESS=(4C0,8) 
CUNUMBR=036 , UNIT=3340, ADDRESS=(5CO,8) 
CUNUMBR=037 , UNIT=3340, ADDRESS=(6CO,8) 
CUNUMBR=038, UNIT=3340, ADDRESS=(7C0,8) 
CUNUMBR=039 , UNIT=3340, ADDRESS=(8CO,8) 
CUNUMBR=03A, UNIT=3340, ADDRESS=(9CO,8) 
CUNUMBR=03B, UNI T=3340, ADDRESS=(ACO,8) 
CUNUMBR=03C , UNIT=3340, ADDRESS=(BCO,8) 


CUNUMBR=03D , UNIT=3350 , ADDRESS=(048,8) 
CUNUMBR=03E , UNI T=3350 , ADDRESS=(148,8) 
CUNUMBR=03F , UNIT=3350 , ADDRESS=(248,8) 
CUNUMBR=040 , UNIT=3350 , ADDRESS=(348,8) 
CUNUMBR=041 , UNIT=3350, ADDRESS=(448,8) 
CUNUMBR=042 , UNIT=3350 , ADDRESS=(548,8) 
CUNUMBR=043 , UNIT=3350 , ADDRESS=(648,8) 
CUNUMBR=044 , UNIT=3350 , ADDRESS=(748,8) 
CUNUMBR=045 , UNIT=3350, ADDRESS=(848,8) 
CUNUMBR=046 , UNIT=3350, ADDRESS=(948,8) 
CUNUMBR=047 , UNIT=3350, ADDRESS=(A48,8) 
CUNUMBR=048 , UNIT=3350 , ADDRESS=(B48,8) 


CUNUMBR=049 , UNIT=3350 , ADDRESS=(030,8) 
CUNUMBR=04A , UNI T=3350, ADDRESS=(130,8) 
CUNUMBR=04B , UNI T=3350, ADDRESS=(230, 8) 
CUNUMBR=04C , UNI T=3350 , ADDRESS=(330,8) 
CUNUMBR=04D , UNI T=3350 , ADDRESS=(430,8) 
CUNUMBR=04E , UNIT=3350, ADDRESS=(530,8) 
CUNUMBR=04F , UNIT=3350 , ADDRESS=(630,8) 
CUNUMBR=050 , UNIT=3350 , ADDRESS=(730,8) 
CUNUMBR=051 , UNIT=3350, ADDRESS=(830, 8) 
CUNUMBR=052 , UNI T=3350, ADDRESS=(930,8) 
CUNUMBR=053 , UNI T=3350 , ADDRESS=(A30,8) 
CUNUMBR=054 , UNIT=3350 , ADDRESS=(B30,8) 


CUNUMBR=055 , UNIT=3350, ADDRESS=(060,8) 
CUNUMBR=056 , UNIT=3350, ADDRESS=(160,8) 
CUNUMBR=057 , UNIT=3350 , ADDRESS=(260,8) 
CUNUMBR=058 , UNI T=3350 , ADDRESS=(360,8) 
CUNUMBR=059 , UNIT=3350 , ADDRESS=(460,8) 
CUNUMBR=05A, UNIT=3350, ADDRESS=(560,8) 
CUNUMBR=05B, UNIT=3350, ADDRESS=(660,8) 
CUNUMBR=05C , UNIT=3350 , ADDRESS=(760,8) 
CUNUMBR=05D , UNIT=3350,, ADDRESS=(860,8) 
CUNUMBR=05E , UNIT=3350 , ADDRESS=(960,8) 
CUNUMBR=05F , UNIT=3350 , ADDRESS=(A60,8) 
CUNUMBR=060 , UNIT=3350, ADDRESS=(B60,8) 


CUNUMBR=061 , UNI T=2305 , ADDRESS=(QFQ, 8) 
CUNUMBR=062 , UNIT=2305 , ADDRESS=(1F0,8) 
CUNUMBR=063 , UNIT=2305 , ADDRESS=(2F0,8) 
CUNUMBR=064 , UNIT=2305 , ADDRESS=(3F0,8) 
CUNUMBR=065, UNIT=2305 , ADDRESS=(4F0,8) 
CUNUMBR=066 , UNI T=2305 , ADDRESS=(5FO0,8) 


Appendix C. VM/XA System Product Starter System Information 


IOCP 


763 


IOCP 


IODEVICE 
IODEVICE 
IODEVICE 
TODEVICE 
IODEVICE 
IODEVICE 


IODEVICE 
IODEVICE 
IODEVICE 
IODEVICE 
TODEVICE 
TODEVICE 
TODEVICE 
TODEVICE 
IODEVICE 
IODEVICE 
IODEVICE 


IODEVICE. 
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CUNUMBR=067 , UNIT=2305 , ADDRESS=(6F0,8) 
CUNUMBR=068 , UNIT=2305 , ADDRESS=(7FO,8) 
CUNUMBR=069 , UNIT=2305 , ADDRESS=(8F0,8) 
CUNUMBR=06A, UNIT=2305, ADDRESS=(9F0,8) 
CUNUMBR=06B , UNIT=2305, ADDRESS=(AFO,8) 
CUNUMBR=06C , UNIT=2305, ADDRESS=(BFO,8) 


CUNUMBR=06D , UNIT=2305, ADDRESS=(0DO,8) 
CUNUMBR=06E , UNIT=2305, ADDRESS=(1D0,8) 
CUNUMBR=06F , UNIT=2305, ADDRESS=(2D0,8) 
CUNUMBR=070, UNIT=2305, ADDRESS=(3D0,8) 
CUNUMBR=07 1, UNIT=2305, ADDRESS=(4D0,8) 
CUNUMBR=072 , UNIT=2305, ADDRESS=(5D0, 8) 
CUNUMBR=073 , UNIT=2305, ADDRESS=(6D0,8) 
CUNUMBR=074 , UNIT=2305, ADDRESS=(7D0,8) 
CUNUMBR=075 , UNIT=2305, ADDRESS=(8D0,8) 
CUNUMBR=076 ,, UNIT=2305, ADDRESS=(9D0,8) 
CUNUMBR=077 , UNIT=2305, ADDRESS=(ADO,8) 
CUNUMBR=078 , UNIT=2305, ADDRESS=(BDO,8) 


CUNUMBR=079 , UNIT=3800, ADDRESS=(018,1) 
CUNUMBR=07A, UNIT=3800, ADDRESS=(118, 1) 
CUNUMBR=07B , UNIT=3800 , ADDRESS=(218, 1) 
CUNUMBR=07C , UNIT=3800 , ADDRESS=(318, 1) 
CUNUMBR=07D , UNIT=3800 , ADDRESS=(418, 1) 
CUNUMBR=07E , UNIT=3800, ADDRESS=(518, 1) 
CUNUMBR=07F , UNIT=3800 , ADDRESS=(618, 1) 


CUNUMBR=080 , UNIT=3278, ADDRESS=(020,8) 
CUNUMBR=081 , UNIT=3278 , ADDRESS=(120, 8) 
CUNUMBR=082 , UNIT=3278 , ADDRESS=(220,8) 
CUNUMBR=083 , UNIT=3278 , ADDRESS=(320,8) 
CUNUMBR=084 , UNIT=3278 , ADDRESS=(420,8) 


CUNUMBR=085 , UNI T=1403 , ADDRESS=(00E, 1) 
CUNUMBR=086 , UNIT=1403 , ADDRESS=(10E, 1) 
CUNUMBR=087 , UNIT=1403 , ADDRESS=(20E, 1) 
CUNUMBR=088 , UNIT=1403 , ADDRESS=(30E, 1) 
CUNUMBR=089 , UNIT=1403 , ADDRESS=(40E, 1) 
CUNUMBR=08A , UNIT=1403 , ADDRESS=(50E, 1) 
CUNUMBR=08B, UNIT=1403 , ADDRESS=(60E, 1) 


CUNUMBR=085 , UNIT=1403 , ADDRESS=(O0F , 1) 
CUNUMBR=086 , UNIT=1403 , ADDRESS=(10F , 1) 
CUNUMBR=087 , UNIT=1403 , ADDRESS=(20F , 1) 
CUNUMBR=088 , UNIT=1403 , ADDRESS=(30F , 1) 
CUNUMBR=089 , UNIT=1403 , ADDRESS=(40F , 1) 
CUNUMBR=08A , UNIT=1403 , ADDRESS=(50F , 1) 
CUNUMBR=08B , UNIT=1403 , ADDRESS=(60F , 1) 


CUNUMBR=085 , UNIT=2540R, ADDRESS=(00C, 1) 
CUNUMBR=086 , UNIT=2540R, ADDRESS=(10C, 1) 
CUNUMBR=087 , UNIT=2540R, ADDRESS=(20C, 1) 
CUNUMBR=088 , UNIT=2540R, ADDRESS=(30C, 1) 
CUNUMBR=089 , UNIT=2540R, ADDRESS=(40C, 1) 
CUNUMBR=08A ,, UNIT=2540R, ADDRESS=(50C, 1) 
CUNUMBR=08B , UNIT=2540R, ADDRESS=(60C, 1) 


CUNUMBR=085 , UNIT=2540P, ADDRESS=(00D, 1) 
CUNUMBR=086 , UNIT=2540P, ADDRESS=(10D, 1) 
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IODEVICE 
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IODEVICE 
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IODEVICE 
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IODEVICE 
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IODEVICE 


CUNUMBR=087 , UNIT=2540P, ADDRESS=(20D, 1) 
CUNUMBR=088 , UNIT=2540P, ADDRESS=(30D, 1) 
CUNUMBR=089 , UNI T=2540P , ADDRESS=(40D, 1) 
CUNUMBR=08A, UNIT=2540P, ADDRESS=(50D,1) 
CUNUMBR=08B, UNIT=2540P , ADDRESS=(60D, 1) 


CUNUMBR=08C , UNIT=3211 , ADDRESS=(002, 1) 
CUNUMBR=08D , UNIT=3211, ADDRESS=(102,1) 
CUNUMBR=08E , UNIT=3211, ADDRESS=(202, 1) 
CUNUMBR=08F , UNIT=3211, ADDRESS=(302,1) 
CUNUMBR=090 , UNI T=3211, ADDRESS=(402, 1) 


CUNUMBR=091 , UNIT=3278 , ADDRESS=(040,8) 
CUNUMBR=092 , UNIT=3278, ADDRESS=(140,8) 
CUNUMBR=093 , UNIT=3278, ADDRESS=(240,8) 
CUNUMBR=094 , UNIT=3278, ADDRESS=(340,8) 
CUNUMBR=095 , UNI T=3278 , ADDRESS=(440,8) 
CUNUMBR=096 , UNI T=3278 , ADDRESS=(540, 8) 
CUNUMBR=097 , UNIT=3278 , ADDRESS=(640,8) 


CUNUMBR=098 , UNI T=3505 , ADDRESS=(012, 1) 
CUNUMBR=099 , UNIT=3505 , ADDRESS=(112, 1) 
CUNUMBR=09A, UNIT=3505, ADDRESS=(212, 1) 
CUNUMBR=09B , UNIT=3505 , ADDRESS=(312, 1) 
CUNUMBR=09C , UNIT=3505 , ADDRESS=(412,1) 


CUNUMBR=098 , UNIT=3525 , ADDRESS=(013, 1) 
CUNUMBR=099 , UNIT=3525 , ADDRESS=(113, 1) 
CUNUMBR=09A , UNIT=3525 , ADDRESS=(213, 1) 
CUNUMBR=09B, UNIT=3525 , ADDRESS=(313, 1) 
CUNUMBR=09C , UNIT=3525, ADDRESS=(413, 1) 


CUNUMBR=09D , UNIT=3375 , ADDRESS=(068, 8) 
CUNUMBR=09E , UNIT=3375, ADDRESS=(168, 8) 
CUNUMBR=09F , UNI T=3375 , ADDRESS=(268, 8) 
CUNUMBR=0A0 , UNIT=3375 , ADDRESS= (368, 8) 
CUNUMBR=0A1 , UNIT=3375, ADDRESS=(468, 8) 
CUNUMBR=0A2 , UNIT=3375, ADDRESS=(568, 8) 
CUNUMBR=0A3 , UNIT=3375 , ADDRESS=(668, 8) 


CUNUMBR=0A4 , UNIT=3375 , ADDRESS=(090,8) 
CUNUMBR=0A5 , UNIT=3375, ADDRESS=(190,8) 
CUNUMBR=0A6 , UNIT=3375, ADDRESS=(290, 8) 
CUNUMBR=0A7 , UNIT=3375, ADDRESS=(390, 8) 
CUNUMBR=0A8 , UNI T=3375, ADDRESS=(490,8) 


CUNUMBR=0A9 , UNI T=3380, ADDRESS=(038, 8) 
CUNUMBR=0AA , UNI T=3380, ADDRESS=(138,8) 
CUNUMBR=0AB, UNI T=3380 , ADDRESS=(238, 8) 
CUNUMBR=0AC , UNI T=3380, ADDRESS=(338, 8) 
CUNUMBR=O0AD , UNI T=3380,, ADDRESS=(438,8) 
CUNUMBR=0AE , UNI T=3380, ADDRESS=(538, 8) 
CUNUMBR=0AF , UNIT=3380,, ADDRESS=(638, 8) 


CUNUMBR=0B0 , UNI T=3380 , ADDRESS=(0A0,8) 
CUNUMBR=0B1 , UNIT=3380 , ADDRESS=(1A0, 8) 
CUNUMBR=0B2 , UNIT=3380 , ADDRESS=(2A0, 8) 
CUNUMBR=0B3 , UNI T=3380 , ADDRESS=(3A0, 8) 
CUNUMBR=0B4 , UNI T=3380 , ADDRESS=(4A0, 8) 


Appendix C. VM/XA System Product Starter System Information 


IOCP 


765 
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IODEVICE CUNUMBR=0B5 , UNIT=3203 , ADDRESS=(003, 1) 
IODEVICE CUNUMBR=0B6 , UNIT=3203 , ADDRESS=(103, 1) 
IODEVICE CUNUMBR=0B7 , UNIT=3203, ADDRESS=(203, 1) 
IODEVICE CUNUMBR=0B8, UNIT=3203 , ADDRESS=(303, 1) 
* 
IODEVICE CUNUMBR=OB9 , UNIT=3480 , ADDRESS=(004, 4) 
IODEVICE CUNUMBR=OBA, UNI T=3480 , ADDRESS=(104, 4) 
IODEVICE CUNUMBR=O0BB, UNIT=3480, ADDRESS=(204, 4) 
IODEVICE CUNUMBR=OBC , UNI T=3480 , ADDRESS=(304, 4) 
* 
IODEVICE CUNUMBR=OBD , UNIT=3890 , ADDRESS=(008, 4) 
IODEVICE CUNUMBR=OBE, UNIT=3890, ADDRESS=(108, 4) 


* 


* 5080 UNIT 

* 
IODEVICE CUNUMBR=OBF , UNIT=HFGD,ADDRESS=(014, 4) 
IODEVICE CUNUMBR=0CO,UNIT=HFGD,ADDRESS=(114,4) 


* 
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HCPSYS ASSEMBLE (3350) 


Sample Files for 3350 Starter System 


IBM provides the following sample files with the VM/XA SP 3350 starter system: 


HCPSYS ASSEMBLE for starter system 
System directory 

System residence DASD allocation 

Minidisk maps of the system residence device. 


Sample HCPSYS ASSEMBLE for 3350 


This is only a sample file. You need to tailor it to your installation before it can be used. 
SYS TITLE 'HCPSYS50 - HCPSYS FOR VM/XA INSTALL BUILD' 


KREKKEKKKKEKKEKEKREKKKEKKEEKEEKRKERKRKERREKEREERERRERRERREREEKRERKEKKRKEKE 


ee Virtual Machine / System Product 5664-308 wae 

nee Contains restricted materials of IBM ane 

a dias Copyright (c) IBM Corporation 1988 *e% 
( : me Licensed Materials - Property of IBM me 


saat Refer to Copyright Instructions: Form G120-2083 nae 


KKKKKRKEKKEEKEKEEEEEKREREEEREREREERRERERERKREREERERERERRERERERKRRKKEK 


KKKKKEKEKKEEKEKERKEEKEKRKERKKREREKEKREKRERERERERERRREEEEKRREKEEREREKERERE 


MODULE NAME - HCPSYS 


DESCRIPTIVE NAME - DEFINITION OF SYSTEM 


FUNCTION - TO DEFINE THE SYSTEM 


REGISTER CONVENTIONS - SYMBOLIC REFERENCES TO REGISTERS ARE 
OF THE FORM "RX" WHERE X IS A NUMBER 
RANGING FROM 0 TO 15 (SEE HCPEQUAT COPY) 
PATCH LABEL - NONE 


MODULE TYPE - DATA 


ert 


PROCESSOR - ASSEMBLER H (VERSION 2) 
ATTRIBUTES - RESIDENT, DATA-ONLY 
MACROS - 


SYSSTORE - DEFINE SYSTEM REAL STORAGE 


+ + £+ € + FF FH HF KF HF FHF HF HF FH HF F FE HF FF FEF HF FH HF FF HF HF HK KF HF KF FH HF F HF F 


SYSRES  - DEFINE 


SYSTEM RESIDENCE VOLUME 


SYSCPVOL - DEFINE SYSTEM VOLUMES 

SYSOPR DEFINE SYSTEM OPERATOR 

SYSTIME DEFINE THE TIME ZONE 

SYSACNT DEFINE ACCOUNTING USERID 

SYSDUMP DEFINE DUMP RECEIVER USERID 

SYSEREP DEFINE EREP RECEIVER USERID 

SYSID DEFINE SYSTEM ID'S BY PROCESSOR 

SYSUVOL DEFINE USER VOLUMES TO BE MOUNTED 

SYSFCN DEFINE PRIV CLASSES ASSIGNED TO CP FUNCTIONS 
SYSEND END SYSTEM GENERATION 
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HCPSYS ASSEMBLE (3350) 


* 
* GENERAL COMMENTS - THIS MODULE IS THE USER'S RESPONSIBILITY. 

* 3 

KKK KKK IIIA KI II IIIA III IK III IIIA III I IIIA IIIS III IIA I ISI AIRE 


SPACE 1 


* THE SYSTEM DEFINITION MACROS SYSSTORE, SYSRES, SYSCPVOL, 
* SYSOPR, AND SYSTIME, ARE CODED HERE, IN ANY ORDER 
SPACE 1 | 
SYSSTORE RMSIZE=32M, VRSIZE=8M, VRFREE=256 
SYSRES SYSVOL=XASRES, 
SYSRES=123, SYSTYPE=3350, 
SYSNUC=003, 
SYSCKP=(013,2), 
SYSWRM=(015,2) , 
SYSTIME ZONE=5,LOC=WEST, ID=EST 
SYSOPR SYSOPER=OPERATOR 
SYSCPVOL XASRES,XASERV,XAPO01, XAPO02, * 
DRUMO1, DRUMO2 , DRUMO3 , DRUMO4 , DRUMO5 , DRUMO6 , DRUMO7 , * —_ 
PAGOO1, PAGOO2 , PAGOO3 , PAGOO4 , PAGOOS , PAGO06 , PAGOQ7 , * : 
SPLOO1,SPLO02,SPLO03, SPLO04, SPLOO5, SPLO06,SPLOO7 
SPACE 1 , 
* ANY OF THE OPTIONAL MACROS THAT ARE DESIRED ARE CODED HERE, 
* IN ANY ORDER 
SPACE 1 
SYSID DEFAULT=INSTTST, (3081A, 3081, 10000) 
SYSACNT USERID=DISKACNT i o~ 
SYSDUMP USERID=OPERATNS | —_ 
SYSEREP USERID=EREP a 
SYSUVOL USRPO1,USRPO2,USRPO3, USRPO4 , USRPO5 , USRPO6 , USRPO7 , * 
USRPO8 , USRPO9 
SYSFCN OPER=A,CPRD=CE, CPWT=C, SERV=F ,DFLT=G 
SPACE 1 


+ + £ 


SPACE 1 | - 
SYSEND oo 


768 Installation and Service 


USER DIRECT (3350) 


Sample Directory for 3350 


This is only a sample file. You need to tailor it to your installation before it can be used. 


KKEKEKKEKKEKKERKEEKREKRKRRERKEREKREERERRERERERRR EERE KE EKREREEREKREKRRKKERER 


ies Virtual Machine / System Product 5664-308 Ane 
anti Contains restricted materials of IBM wee 
nae Copyright (c) I BM Corporation 1988 ase 
=e Licensed Materials - Property of IBM Eee 


re Refer to Copyright Instructions: Form G120-2083 a 


KKEKKEKEKKEKKEKEKREKEKRERERERERKERKRREKRERKKREREREEREREREREREKRERKEKER 


KKEKKKEKEKEKEKREKKEKEKEKRERKRERKKEKRERKRERERERERERERERERREREREKERERKERKKREERE 


3350 SYSTEM VM/XA SYSTEM PRODUCT DIRECTORY 

THE ADDRESSES 123, 124, AND 125 ARE VIRTUAL ADDRESSES. 

THE ADDRESS 123 IS CRITICAL SINCE IT IS USED IN HCPSYS AND 
THE DIRECTORY. IF YOU WANT TO CHANGE IT, REMEMBER IT MUST 
BE CHANGED IN HCPSYS, THE ‘DIRECTORY’ STATEMENT BELOW, 

AND IN THE 'MDISK' STATEMENTS FOR THE USERID ‘MAINT’. 
NOTE: REMEMBER THESE ARE ONLY VIRTUAL ADDRESSES NOT REAL 
ADDRESSES, SO THERE IS NO NEED TO CHANGE THEM TO MATCH 
YOUR HARDWARE ADDRESSES. 


THIS DIRECTORY MUST BE MODIFIED IF MDISK PASSWORDS ARE TO 
BE SPECIFIED. WITHOUT MDISK PASSWORDS, MDISKS CANNOT BE 
SHARED USING THE ‘CP LINK’ COMMAND. A SAMPLE USER ENTRY 
FOLLOWS: (NOTE ONLY THE MDISK STATEMENT) 


USER ANYONE SOMEPASS 3M 8M FG 
AUTOLOG AUTOLOG1 OP1 MAINT 
IPL 190 
CONSOLE O1F 3215 
SPOOL QOC 2540 READER A 
SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 
*e===>  MDISK 999 33XX XXX YYY ZZZZZZ MR RPASS WPASS MPASS 


e+ + FF FF FE FE FF HF FF FH HF KF FF HF HF HF FF HF HF HF FHF KF F 


WHERE: RPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 
READ ONLY MODE. 
WPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 
WRITE MODE. 
MPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 
MULTI-WRITE MODE. 


NOTE: EACH PASSWORD MAY BE 1-8 CHARACTERS IN LENGTH. 


> 
ran) 
ro) 
r—) 
ons 
=z 
+ 
~ 
~_ 
~~ 
~ 
~~ 
a) 

SH HF FH HF HH FH H FH HF HF HF HF HF HF HF HF HF HF HF HF HF HF HF HF HF FH *F 


t+ +£ F £ ££ FF HF F HF F 


KKEKKEKEKEKRKEKREKREKEKREERRKRERERKEERRERERRREKRREREREREREKREEREKREKREKREKER 


Following is a sample user entry and a brief description 
of each entry. A more detailed description may be found | 
by referencing the VM/XA System Product Planning and 
Administration manual. 


USER CMS1 abcl123 3M 32M G 
- Userid is CMS1 
- Logon password is abcl23 
- At logon time, virtual storage will equal 3M 
- Maximum storage that may be defined equals 32M 
- Privilege class is G 


+ + + F F FF F FF F * F 
¥ * FF ¥ FF FF F F F HF 
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USER DIRECT (3350) 


AUTOLOG AUTOLOG1 OP1 MAINT 
- Allows user CMS1 to be autolog'd by AUTOLOGI, 
OP1, and MAINT | 


ACCOUNT ACT4 CMSTST 
- Time used by CMS1 will be charged to account ACT4 
- Printed output will be sent to distribution CMSTST 


IPL CMS 
- Will cause automatic IPL of named save system of 
CMS 


CONSOLE 009 3215 
- Defines virtual machines console as a 3215 at a 
virtual address of 009 


SPOOL OOC 2540 READER A 
SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 
- Defines virtual unit record devices of reader, 
punch, and printer with a spooling class of 'A' 


LINK MAINT 190 190 RR 
- Allows read access to minidisk 190 of user 'MAINT' 


LINK MAINT 19E 19E RR 
= Allows read access to minidisk 19E of user 'MAINT' 


LINK MAINT 19D 19D RR 
- Allows read access to minidisk 19d of user ‘MAINT’ 


MDISK 999 3350 236 022 CPPACK WR RPASS WPASS 

- Defines minidisk with a virtual address of 999 

- Specifies that the minidisk resides on a real 3350 

- Minidisk starts at cylinder 236 

- Mdisk is 22 cylinders in size (starting at cyl 236 

- The real volume serial number is 'CPPACK' 

- Mdisk is to be accessed in write mode if no other 
user has write access. Alternate access read-only 

- RPASS is the required password for another user to 
link to this minidisk in read mode 

- WPASS is the required password for another user to 
link to this minidisk in write mode 


+ £ + FH FF FF FF FH HF F HF Fe HF HF F HF HF HF HF HF HF HF HF HF HK HF HF HF HF FF FH F KF KX FF 
+ t+ +t FF FH HF HF FF HF HF HF HF HF HF HF HF HK HF HF HF HF KF HF HF FF HF HF KF HF HF HF HF HF HF HF HF HK F 


KRRREKRERERERREEKRERREKEREREKRRRERERERERERRREKRREEREREREREKRRRREKRKEKRRRERREKRE 


DIRECTORY 123 3350 XASRES 


* 
BRERERKEKRERKREREREERRERERERERREREREERRREREEREERRERERERERRERKEKKREEKREKRE 
* SYSTEM RESERVED AREAS NOT FOR MINIDISKS * 
KKRKEREKREKKREKERERRRERRKRKRRERERER EKER KRREREREREEKERERKRKRERERKRERERE 
* 


USER $ALLOC$ NOLOG 

MDISK AO1 3350 000 001 XASRES R 
MDISK BQ1 3350 000 001 XASERV R 
MDISK CO1 3350 000 001 XAPQO1 R 


770 Installation and Service 


MDISK DO1 3350 000 001 XAPQ02 R 
* 

USER $DIRECT$ NOLOG 

MDISK A04 3350 001 002 XASRES R 
* 

USER $CP-NUC$ NOLOG 

MDISK AO9 3350 003 010 XASRES R 
* 

USER $SYSCKP$ NOLOG 

MDISK AQ6 3350 013 002 XASRES R 
* 

USER $SYSWRM$ NOLOG 

MDISK AO7 3350 015 002 XASRES R 
* 

USER $PAGE$ NOLOG 

MDISK AQ3 3350 017 025 XASRES R 
* 

USER $SPOOL$ NOLOG 

MDISK BO1 3350 042 060 XASRES R 
* 

USER $T-DISK$ NOLOG 

MDISK BO1 3350 320 020 XASRES R 


* 
KEKKKEKKKEKEEKKERERKEKRERKEKREREREKREREKREREREREREKREREKEREREREREKRERERERE 
* CMS USERIDS * 
KKKKEKEKKEERERERERREREKREKRKEEREKREKEREREREKEEKRERRERERKREKRKEKKREKEREKREREEK 
* 


USER CMS1 NOLOG 3M 32M G 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT ACT4 CMSTST 

IPL CMS 
CONSOLE 009 3215 
SPOOL OOC 2540 READER A 
SPOOL QOD 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 


* 
KKEEKEREKREKREKREREKRREKRRERERKREKKREREKREKEREREREREREEKREKRREKERKEKRERKERKRKRERER 
* PROP LOGICAL OPERATOR * 
KEKKEKEKKEKRKREKKEKKEEKEKRERKEKREREKEKRKREKEKEREEKRERERERREKRERREKEKKREKEKEKREERERE 
* 


USER LGLOPR NOLOG 512K 16M ABCDEG 
ACCOUNT ACT1 PROP 
IPL CMS 


. CONSOLE 009 3215 


SPOOL OOC 2540 READER A 

SPOOL 00D 2540 PUNCH A 

SPOOL OOE 1403 A 

MDISK 191 3350 273 001 XASRES WR 
LINK MAINT 194 194 RR 

LINK MAINT 190 190 RR 

LINK OPERATOR 191 291 RR 


* 
KKEKKEKRKEREREEREKERREERKRERKERERKEKREREERREREKRRERERRERERREKRERKERERER 
* SYSTEM RELATED USERIDS * 
KRRKEKREKKERKREREEERKREEREREERRRERERREKREKRKREKRREEREKERREREREREKKRREKREEE 
* 


USER MAINT NOLOG 16M 32M ABCDEFG 


USER DIRECT (3350) 
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USER DIRECT (3350) 


AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 1 SYSPROG 

IPL 190 

_NAMESAVE GCS 

NAMESAVE VTAM 
NAMESAVE HELP 
NAMESAVE INSTHELP 
CONSOLE 009 3215 T 


SPOOL 
SPOOL 
SPOOL 
MDISK 
MDISK 
MDISK 
. MDISK 


MDISK 
MDISK 
MDISK 
MDISK 


MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 


MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 


MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 


MDISK 
MDISK 
MDISK 


MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
* 
MDISK 
MDISK 


772 


00C 
00D 
O0E 
123 
124 
125 
126 


191 
193 
194 
201 


192 
392 
492 
692 
593 
594 


295 
395 
495 
592 
892 
491 
791 
89E 
896 
895 


293 
294 
393 
394 
19C 
49C 


190 
19E 
19D 


291 
391 
591 
691 
49D 
501 
595 


490 
423 


2540 
2540 
1403 
3350 
3350 
3350 
3350 


3350 
3350 
3350 
3350 


3350 
3350 
3350 
3350 
3350 
3350 


3350 
3350 
3350 
3350 
3350 
3350 
3350 
3350 
3350 
3350 


3350 
3350 
3350 
3350 
3350 
3350 


3350 
3350 
3350 


3350 
3350 
3350 
3350 
3350 
3350 
3350 


3350 
3350 


READER * 

PUNCH A 

A ‘ 
000 555 XASRES 
009 555 XAPOO1 
000 555 XASERV 
000 555 XAPOO2 


370 016 XASRES 
414 060 XASRES 
001 065 XASERV 
066 028 XASERV 


094 019 XASERV 
113 019 XASERV 
132 013 XASERV 
145 013 XASERV 
158 050 XASERV 
396 075 XAPOO2 


474 038 XASRES 
512 025 XASRES 
280 007 XASERV 
287 013 XASERV 
300 007 XASERV 
307 013 XASERV 
320 013 XASERV 
333 013 XASERV 
346 013 XASERV 
359 013 XASERV 


372 075 XASERV 
447 100 XASERV 
326 070 XAPOOZ2 
001 163 XAPQO1 
229 037 XAPQO1 
266 037 XAPOQO1 


123 074 XASRES 
303 055 XAPOO1 
358 037 XAPOQO1 


395 075 XAPO01 
470 050 XAPOO1 
001 075 XAPQ02 
076 050 XAPOQ02 
126 037 XAPOQ02 
163 003 XAPOQ02 
166 016 XAPOQ02 


182 074 XAPOQ02 
272 013 XAPOQOZ 


Installation and Service 


RMAINT WMAINT MMAINT 


READ WRITE MULTIPLE 
READ WRITE MULTIPLE 
READ WRITE MULTIPLE 
READ WRITE MULTIPLE 
READ WRITE MULTIPLE 
READ WRITE MULTIPLE 


READ WRITE MULTIPLE 
READ WRITE MULTIPLE 
READ WRITE MULTIPLE 
READ WRITE MULTIPLE 
READ WRITE MULTIPLE 
READ WRITE MULTIPLE 
READ WRITE MULTIPLE 
READ WRITE MULTIPLE 
READ WRITE MULTIPLE 
READ WRITE MULTIPLE 


RCMSAUX WCMSAUX MCMSAUX 
RCPAUX WCPAUX MCPAUX 
ALL 

ALL 

ALL 

READ WRITE MULTIPLE 


READ WRITE MULTIPLE 
READ WRITE MULTIPLE 
READ WRITE MULTIPLE 
READ WRITE MULTIPLE 


MDISK 596 3350 285 025 XAPO02 
MDISK 59E 3350 310 013 XAPOOZ2 


* 


MW 
MW 


USER DIRECT (3350) 


* MDISK STATEMENTS FOR INSTALL & SERVICE OF RSCS & PASS-THROUGH 
MDISK 36E 3350 323 003 XAPOQ2 RR RPVM WPVM MPVM 


LINK RSCS 


* 


USER CMSBATCH NOLOG 1M 2M G 


191 499 MW 


ACCOUNT 3 SYSTEM 
OPTION ACCT 


IPL CMS PARM AUTOCR 


CONSOLE 009 3215 


SPOOL OOC 2540 READER * 
SPOOL OOD 2540 PUNCH A 


SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
MDISK 195 3350 274 002 XASRES MR RBATCH WBATCH MBATCH 


* 


USER GCS NOLOG 16M 16M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT GCS RECVM 


IPL GCS 


NAMESAVE GCS 
CONSOLE 009 3215 


SPOOL OOC 2540 READER * 
SPOOL QOD 2540 PUNCH A 


SPOOL OOE 1403 A 


LINK MAINT 190 190 RR 
LINK MAINT 19D 19D RR 
LINK MAINT 595 595 
LINK MAINT 59E 59E 


MDISK 191 3350 243 004 XASRES MR RGCS WGCS MGCS 


* 


USER SYSMAINT 
AUTOLOG AUTOLOG1 OP1 MAINT 


ACCOUNT 1 SYSPROG 


IPL CMS 


CONSOLE 009 3215 T 


SPOOL OOC 2540 
SPOOL OOD 2540 


SPOOL OOE 1403 A 

LINK MAINT 123 123 
LINK MAINT 191 192 
LINK MAINT 190 190 
LINK MAINT 19E 19E 
LINK MAINT 19D 19D 


* 


USER OPERATOR 
AUTOLOG AUTOLOG1 OP1 MAINT 


ACCOUNT 2 OPERATOR 
CONSOLE 009 3215 T 


SPOOL O0C 2540 READER * 
SPOOL OOD 2540 PUNCH A 


SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 191 3350 386 005 XASRES MR 
191 192 RR 


LINK OP1 


READER * 
PUNCH A 


MW 
RR 
RR 
RR 
RR 


NOLOG 3M 32M ABCDEFG 


NOLOG 16M 32M ABCDEFG 
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USER DIRECT (3350) 


*OP1 IS AN ALTERNATE OPERATOR USERID 
* 
USER OP1 NOLOG 3M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 

ACCOUNT 3 OPERATOR 

IPL CMS 

CONSOLE 009 3215 

SPOOL O0C 2540 READER * 

SPOOL OOD 2540 PUNCH A 

SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

| MDISK 191 3350 391 001 XASRES MR 
LINK OPERATOR 191 192 RR 


This userid is for the IBM CE's use in running 

OLTSEP. 

OLTSEP is automatically IPLed in the virtual machine. 7 

A minimum machine size of one megabyte is required to — 
run OLTSEP. "es. 
The privilege class of F allows the CE to specify 

intensive recording mode. 

The console address of O1F is required by OLTSEP. 

The unit record addresses are those required by 

OLTSEP. 

The 5FF minidisk is the CE's OLTSEP pack. 


+ FF F FF F HF HF F HF F 


! USER OLTSEP NOLOG 3M 8M FG 


AUTOLOG AUTOLOG1 OP1 MAINT a 
: ACCOUNT OLTSEP IBMCE C > 
| IPL 5FF es 


CONSOLE O1F 3215 

SPOOL OOC 2540 READER A 

SPOOL OOD 2540 PUNCH A 

SPOOL OQE 1403 A 

MDISK 5FF 3350 000 555 CEPACK MR 


** EREP **k 


This userid is for the IBM CE's use in running | f 
CPEREP. 7 
CMS is automatically IPLed in the virtual machine. 

The 190 minidisk is the CMS system disk. 

The 191 minidisk may be used to save often-used EREP 

control statements and procedures (EXECs). 

THE 190 MINIDISK HAS THE CMS TXTLIBS NECESSARY TO RUN 

EREP. 


+ +* ++ €£$ $F + FF FH FF KF HF F 


USER EREP NOLOG 3M 8M BFG 
AUTOLOG AUTOLOG1 OP1 MAINT © 
ACCOUNT EREP IBMCE 
IPL CMS 
CONSOLE O1F 3215 
SPOOL OOC 2540 READER A 
SPOOL QOD 2540 PUNCH B 
SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 201 201 RR 
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USER DIRECT (3350) 


MDISK 191 3350 412 Q02 XASRES WR READ WRITE MULTIPLE 
* 
( : USER OPERATNS NOLOG 3M 8M BCEG 
ae AUTOLOG AUTOLOG1 OP1 MAINT 

ACCOUNT 1 OPERATNS 

IPL CMS 

CONSOLE 009 3215 

SPOOL O@C 2540 READER D 

SPOOL 00D 2540 PUNCH A 

SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

MDISK 191 3350 392 017 XASRES MR RDVF WDVF MDVF 


* 
* 


USER IPCS NOLOG 3M 8M BCEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
pP, ACCOUNT 8 CE-ROOM 
( IPL CMS 
CONSOLE 009 3215 
SPOOL OOC 2540 READER * 
SPOOL QOD 2540 PUNCH A 
SPOOL QOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
LINK OPERATNS 193 192 RR 
* 
( ; USER AUTOLOG1 NOLOG 3M 8M ABCDEG 
ie AUTOLOG OP1 MAINT 
ACCOUNT 9 SYSTEM 
IPL CMS 
CONSOLE 009 3215 
SPOOL OC 2540 READER * 
SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
MDISK 191 3350 409 Q01 XASRES MR RAUTOLOG WAUTOLOG MAUTOLOG 


( | USER DISKACNT NOLOG 3M 8M BG 
- AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 10 ACCNTNG 
IPL CMS 

CONSOLE 909 3215 

SPOOL OOC 2540 READER * 
SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

MDISK 191 3350 410 001 XASRES MR READ WRITE MULTIPLE 
* 
USER IBMPSR NOLOG 3M 8M BG 
ACCOUNT 10 ACCNTNG 

IPL CMS 

CONSOLE 009 3215 

SPOOL Q@0C 2540 READER * 
SPOOL 00D 2540 PUNCH A 
SPOOL QOE 1403 A 
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USER DIRECT (3350) 


LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 191 3350 411 001 XASRES MR 

* 

USER IVPM2 NOLOG 3M 4MG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT ACT5 IVPM2 
CONSOLE 009 3215 
SPOOL O@C 2540 READER A 
SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 194 194 RR 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 

* 

USER VMUTIL NOLOG 3M 8M BDEG 
AUTOLOG AUTOLOG1 OP1 MAINT yes 
ACCOUNT 11 SYSTEM a 

IPL CMS ad 

CONSOLE 009 3215 
SPOOL O0C 2540 READER * 

SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 

* 

USER SYSDUMP1 NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT ug 
ACCOUNT 12 SYSTEM 

IPL CMS 

CONSOLE 009 3215 
SPOOL OOC 2540 READER * 

SPOOL 00D 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR | — 
MDISK 123 3350 000 555 XASRES RR te 
MDISK 124 3350 000 555 XAPOOQ1 RR - 
MDISK 125 3350 000 555 XASERV RR 
MDISK 126 3350 @00 555 XAPOO2 RR 


* 


* 


USER RSCS NOLOG 3M 8M BEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 13 SYSTEM 
NOPDATA 

IPL 191 

CONSOLE 009 3215 

SPOOL OOC 2540 READER * 
SPOOL GOD 2540 PUNCH A 
SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
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USER DIRECT (3350) 


MDISK 191 3350 316 002 XASRES MR RRSCS WRSCS MRSCS 

* 

USER PVM NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 14 SYSTEM 

IPL CMS 

CONSOLE 009 3215 

SPOOL O0C 2540 READER * 
SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
LINK MAINT 36E 191 MR 


* 


* 


KKRKEKEKKREREKRKEEKKRERREKEKRKEREREKREREEKREEKRKRERREKKREKREEKRERERKKEKRKKEKE 


m OTHER OPERATING SYSTEM USERIDS = 
sks HH KAI K IK KIRK IK IIIS I III IIA I III IIIA AIK III IAI II IAI II ISI IAKR 
( ' 
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XAMAINT Directory Entry (3350) 


Sample XAMAINT Directory Entry for 3350 


If you are using the procedure in Chapter 4, “Installing VM/XA System Product Release 2 Using an Existing 
VM/SP or VM/SP HPO System” on page 219 to install your system, add the following entry to your 
directory: 


* 


USER XAMAINT NOLOG 16M 16M ABCDEFG 

OPTION ECMODE DIAG98 

ACCOUNT 1 SYSPROG 

IPL 190 
*NAMESAVE GCS 
*NAMESAVE VTAM 
*NAMESAVE HELP 
*NAMESAVE INSTHELP 

CONSOLE 009 3215 T 

SPOOL @OC 2540 READER * 

SPOOL OOD 2540 PUNCH A 

SPOOL OGE 1403 A a 
MDISK 123 3350 000 555 XASRES MW U 
MDISK 124 3350 060 555 XAPOO1 RR ~ 
MDISK 125 3350 000 555 XASERV RR 

MDISK 126 3350 000 555 XAPOO2 RR 


MDISK 191 3350 370 016 XASRES MW 
MDISK 193 3350 414 060 XASRES MW 
MDISK 194 3350 001 065 XASERV MW 
MDISK 201 3350 066 028 XASERV MW RMAINT WMAINT MMAINT - 


MDISK 192 3350 094 019 XASERV MW READ WRITE MULTIPLE ( ‘ 
MDISK 392 3350 113 019 XASERV MW READ WRITE MULTIPLE Lae 
MDISK 492 3350 132 013 XASERV MW READ WRITE MULTIPLE 

MDISK 692 3350 145 013 XASERV MW READ WRITE.MULTIPLE © 

MDISK 593 3350 158 Q50 XASERV MW READ WRITE MULTIPLE 

MDISK 594 3350 396 075 XAPQO2 MW READ WRITE MULTIPLE 


MDISK 295 3350 474 038 XASRES MW READ WRITE MULTIPLE 

MDISK 395 3350 512 025 XASRES MW READ WRITE MULTIPLE 

MDISK 495 3350 280 007 XASERV MW READ WRITE MULTIPLE 

MDISK 592 3350 287 013 XASERV MW READ WRITE MULTIPLE “os 
MDISK 892 3350 300 007 XASERV MW READ WRITE MULTIPLE \ J 
MDISK 491 3350 307 013 XASERV MW READ WRITE MULTIPLE ; 
MDISK 791 3350 320 013 XASERV MW READ WRITE MULTIPLE 

MDISK 89E 3350 333 013 XASERV MW READ WRITE MULTIPLE 

MDISK 896 3350 346 013 XASERV MW READ WRITE MULTIPLE 

MDISK 895 3350 359 013 XASERV MW READ WRITE MULTIPLE 


MDISK 293 3350 372 075 XASERV MW RCMSAUX WCMSAUX MCMSAUX 
MDISK 294 3350 447 100 XASERV MW RCPAUX WCPAUX MCPAUX 
MDISK 393 3350 326 070 XAPQ02 WR 
MDISK 394 3350 001 163 XAPOQQ1 WR 
MDISK 19C 3350 229 Q37 XAPQ01 WR 

MDISK 49C 3350 266 037 XAPO01 WR 


MDISK 190 3350 123 074 XASRES MW ALL 
MDISK 19E 3350 303 055 XAPQO1 MW ALL 
MDISK 19D 3350 358 037 XAPOO1 MW ALL 


MDISK 291 3350 395 075 XAPQO1 MW 
MDISK 391 3350 470 050 XAPQ01 MW 
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XAMAINT Directory Entry (3350) 


MDISK 591 3350 001 075 XAPOQ@2 MW READ WRITE MULTIPLE 
MDISK 691 3350 076 050 XAPOQ@2 MW READ WRITE MULTIPLE 
MDISK 49D 3350 126 037 XAPOQ2 MW READ WRITE MULTIPLE 
MDISK 501 3350 163 003 XAPOO2 MW READ WRITE MULTIPLE 
MDISK 595 3350 166 016 XAPOQ2 MW READ WRITE MULTIPLE 


MDISK 490 3350 182 074 XAPOQ2 MW 

MDISK 423 3350 272 013 XAPOQ2 MW 

MDISK 596 3350 285 025 XAPOQ2 MW 

MDISK 59E 3350 310 013 XAPQO2 MW 
* 
* MDISK STATEMENTS FOR INSTALL & SERVICE OF RSCS & PASS-THROUGH 
MDISK 36E 3350 323 003 XAPOQ2 RR RPVM WPVM MPVM 

LINK RSCS 191 499 MW 

LINK MAINT 190 390 RR 


* 
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XASRES Volume Allocation (3350) 


System Residence DASD Allocation for 3350 


Figure 54 shows the allocation for the system residence device for the 3350 VM/XA SP Starter System. | 


TYPE CYL CYL 
PERM 000-000 
DRCT 001-002 
PERM 003-013 
PAGE 014-038 
SPOL 039-077 
PERM 078-205 
TDSK 206-225 
PERM 226-554 


Figure 54. System Residence DASD Allocation for 3380 
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Minidisk Maps (3350) 


Minidisk Maps for 3350 System Residence Device 


C Figure 55 shows the minidisk maps for the system residence device for the 3350. To map your own system 
ae residence device for comparison, issue DISKMAP fn DIRECT, where fn is the name of your directory. 


VOLUME USERID CUU DEVTYPE START END SIZE 
CEPACK OLTSEP 5FF 3350 0000 0554 0555 
VOLUME USERID CUU DEVTYPE START END SIZE 
XAPQO1 $ALLOC$ COl 3350 0000 0000 0001 
MAINT 394 3350 0001 0163 0163 
164 228 65 GAP 

PMs MAINT 19C 3350 0229 0265 0037 
( | MAINT 49C 3350 0266 0302 0037 
MAINT 19E 3350 0303 Q357 0055 
MAINT 19D 3350 0358 Q394 0037 
MAINT 291 3350 Q395 0469 0075 
MAINT 391 3350 0470 Q519 0050 

MAINT 124 3350 0000 0554 0555 **QVERLAP** 


SYSDUMP1 124 3350 0000 0554 0555 **OVERLAP** 


( " VOLUME USERID CUU = DEVTYPE START END SIZE 
XAPOO2 $ALLOC$ DO1 3350 0060 0000 0001 
MAINT 591 3350 0001 0075 0075 
MAINT 691 3350 0076 0125 0050 
MAINT 49D 3350 0126 0162 0037 
MAINT 501 3350 0163 0165 0003 
MAINT 595 3350 0166 0181 0016 
MAINT 490 3350 0182 0255 0074 
256 2/1} 16 GAP 

MAINT | 423 3350 0272 0284 0013 
— MAINT 596 3350 0285 0309 0025 
( MAINT 59E 3350 0310 0322 0013 
MAINT 36E 3350 0323 0325 0003 
MAINT 393 3350 0326 0395 0070 
MAINT 594 3350 0396 0470 0075 

MAINT 126 3350 0000 0554 0555 **OVERLAP** 


SYSDUMP1 126 3350 0000 0554 0555 **OVERLAP** 


Figure 55 (Part | of 3). Minidisk Maps of the System Residence Device for 3350 
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Minidisk Maps (3350) 


VOLUME USERID CUU DEVTYPE START END SIZE 
XASERV $ALLOC$ BO1 3350 0000 0000 0001 
MAINT 194 3350 0001 0065 0065 
MAINT 201 3350 0066 0093 0028 
MAINT 192 3350 0094 0112 0019 
MAINT 392 3350 0113 0131 0019 
MAINT 492 3350 0132 0144 0013 
MAINT 692 3350 0145 0157 0013 
MAINT 593 3350 0158 0207 0050 
208 279 72 GAP 
MAINT 495 3350 0280 0286 0007 
MAINT 592 3350 0287 0299 0013 
MAINT 892 3350 0300 0306 0007 
MAINT 491 3350 0307 Q319 0013 
MAINT 791 3350 0320 0332 0013 
MAINT 89E 3350 0333 0345 0013 7 es 
MAINT 896 3350 0346 0358 0013 . he 
MAINT 895 3350 0359 0371 0013 
MAINT 293 3350 0372 0446 0075 
MAINT 294 3350 0447 0546 0100 
MAINT 125 3350 0000 0554 Q555 **OVERLAP** 


SYSDUMP1 125 3350 0000 0554 0555 **OVERLAP** 


VOLUME USERID CUU DEVTYPE START END SIZE on 
XASRES  $ALLOC$ AQ1 3350 0000 0000 0001 ‘ g 
$DIRECT$ A04 3350 0001 0002 0002 — 
$CP-NUC$ AQ9 3350 0003 0012 0010 
$SYSCKP$ A06 3350 0013 0014 0002 
$SYSWRM$ AQ7 3350 0015 0016 0002 


$PAGE$ A03 3350 0017 0041 0025 
$SPOOL$ BO1 3350 0042 0101 0060 
102 122 21 GAP 
MAINT 190 3350 0123 0196 0074 
197 242 46 GAP : 
Figure 55 (Part 2 of 3). Minidisk Maps of the System Residence Device for 3350 Me ei 
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Minidisk Maps (3350) 


C GCS 
ae LGLOPR 
CMSBATCH 


RSCS 


$T-DISK$ 


MAINT 

OPERATOR 191 
OP1 191 
OPERATNS 191 
AUTOLOG] 191 
DISKACNT 191 


IBMPSR 191 

| EREP 191 
( MAINT 193 
| MAINT 295 


MAINT 395 
MAINT 123 0555 **OVERLAP** 
SYSDUMP1 123 Q555 **QVERLAP** 


Figure 55 (Part 3 of 3). Minidisk Maps of the System Residence Device for 3350 
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HCPSYS ASSEMBLE (3375) 


Sample Files for 3375 Starter System 


IBM provides the following sample files with the VM/XA System Product 3375 starter system: 


HCPSYS ASSEMBLE for starter system 


System directory 


System residence DASD allocation 
Minidisk maps of the system residence device. 


Sample HCPSYS ASSEMBLE for 3375 


This is only a sample file. You need to tailor it to your installation before it can be used. 


SYS TITLE 'HCPSYS75 - HCPSYS FOR VM/XA INSTALL BUILD' 
KKKEKKEKKEKEKKEKEKRRREKEKRREKRRRERERRRERREKRKRRKRRKRR RRR 
Virtual Machine / System Product 5664-308 
Contains restricted materials of IBM 


KKK 


KkK* 


KKEKKREREEKEKKRERERERERE RE EREREERE RRR REREREREREREKEREKREKEEKREEKRKEREERE 


+ ££ + & € F HF HF HF HF HF HF FF HF FF HF HH HF FHF HF KF HF HF FF HK HF KF HF HF HF KF KF HF HF HF 


784 


Copyright (c) 


IBM 


Licensed Materials - 
Refer to Copyright Instructions: Form G120-2083 


KREKKKEKEKKEKKEEKKEKREKREREKRERKKKREREREKREREKEKKEREREEKRERKERKEEKEKKEKRKRE 


MODULE NAME - HCPSYS 


REGISTER CONVENTIONS - SYMBOLIC REFERENCES TO REGISTERS ARE 
OF THE FORM "RX" WHERE X IS A NUMBER 
RANGING FROM @ TO 15 (SEE HCPEQUAT COPY) 


PATCH LABEL - NONE 


MODULE TYPE - DATA 


Corporation 1988 
Property of I BM 


DESCRIPTIVE NAME - DEFINITION OF SYSTEM 


FUNCTION - TO DEFINE THE SYSTEM 


PROCESSOR - ASSEMBLER H (VERSION 2) 


ATTRIBUTES - RESIDENT, DATA-ONLY 


MACROS - 


SYSSTORE - 
SYSRES- 
SYSCPVOL - 
SYSOPR- 
SYSTIME - 
SYSACNT - 
SYSDUMP - 
SYSEREP - 
SYSID - 
SYSUVOL - 
SYSFCN - 
SYSEND- 


Installation and Se 


DEFINE 
DEFINE 
DEFINE 
DEFINE 
DEFINE 
DEFINE 
DEFINE 
DEFINE 
DEFINE 
DEFINE 
DEFINE 


SYSTEM REAL STORAGE 

SYSTEM RESIDENCE VOLUME 
SYSTEM VOLUMES 

SYSTEM OPERATOR 

THE TIME ZONE 

ACCOUNTING USERID 

DUMP RECEIVER USERID 

EREP RECEIVER USERID 
SYSTEM ID'S BY PROCESSOR 
USER VOLUMES TO BE MOUNTED 


PRIV CLASSES ASSIGNED TO CP FUNCTIONS 


END SYSTEM GENERATION 


rvice 


Ke 
KEK 
*#*K* 
*Kk* 
kKk 


HCPSYS ASSEMBLE (3375) 


* 


* GENERAL COMMENTS - THIS MODULE IS THE USER'S RESPONSIBILITY. 


* 


KEKKEKKEKKEKRKKEEKEKREREKRREKRRERKEKREKREERRERERRRKEERREREKREKRRKREKREREREREREREEKER 


SPACE 1 
* THE SYSTEM DEFINITION MACROS SYSSTORE, SYSRES, SYSCPVOL, 
* SYSOPR, AND SYSTIME, ARE CODED HERE, IN ANY ORDER 
SPACE 1 
SYSSTORE RMSIZE=32M, VRSIZE=8M, VRFREE=256 
SYSRES SYSVOL=XASRES, 
SYSRES=123, SYSTYPE=3375, 
SYSNUC=005, 
SYSCKP=(021,4) , 
SYSWRM=(025,4) 
SYSTIME ZONE=5,LOC=WEST, ID=EST 
on SYSOPR SYSOPER=OPERATOR 
( ; SYSCPVOL XASRES , XASERV, XAPOQ1, 
| DRUMO1, DRUMO2 , DRUMO3, DRUMO4 , DRUMO5 , DRUMO6,, DRUMO7 , * 
PAGOO1,PAGQ02 , PAGOO3, PAGOO4 , PAGOOS , PAGOO6 , PAGOO7 , 
SPLOO1,SPLO02,SPLO03,SPLO04,SPLOQ5,SPLO06,SPLQ07 
SPACE 1 


% % FF 


* ANY OF THE OPTIONAL MACROS THAT ARE DESIRED ARE CODED HERE, 
* IN ANY ORDER 


SPACE 1 
es SYSID DEFAULT=INSTTST, (3081A, 3081, 10000) 
( / SYSACNT USERID=DISKACNT 


SYSDUMP USERID=OPERATNS 

SYSEREP USERID=EREP 

SYSUVOL USRPOQ1,USRPO2, USRPO3, USRPO4, USRPO5 , USRP06, USRPO7 , * 
USRPO8, USRPO9 

SYSFCN OPER=A,CPRD=CE,CPWT=C,SERV=F ,DFLT=G 

SPACE 1 


( SPACE 1 
‘. SYSEND 
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USER DIRECT (3375) 


Sample Directory for 3375 


This is only a sample file. You need to tailor it to your installation before it can be used. 


KRKEEKKEEREREREKRRERERERERERERRERRRREERRREREREREREREREREEERRERREEKEE 


lial Virtual Machine / System Product 5664-308 nae 
eee Contains restricted materials of IBM ili 
eee Copyright (c) I BM Corporation 1988 sa 
nee Licensed Materials - Property of I BM RS 


saad Refer to Copyright Instructions: Form 6120-2083 nee 


KEKEKEKRERKEREKREKREKREKRRKRERERERKERRRERERERRRERERERREREERERERRERE 
KEKEKRKEKEREREEREREKRERERERREEEREKRRERRERERRERERRRERERRERERRERRERREREEE 


3375 SYSTEM VM/XA SYSTEM PRODUCT DIRECTORY 

THE ADDRESSES 123, 124, AND 125 ARE VIRTUAL ADDRESSES. 

THE ADDRESS 123 IS CRITICAL SINCE IT IS USED IN HCPSYS AND 
THE DIRECTORY. IF YOU WANT TO CHANGE IT, REMEMBER IT MUST 
BE CHANGED IN HCPSYS, THE 'DIRECTORY' STATEMENT BELOW, 

AND IN THE 'MDISK' STATEMENTS FOR THE USERID ‘MAINT’. 
NOTE: REMEMBER THESE ARE ONLY VIRTUAL ADDRESSES NOT REAL 
ADDRESSES, SO THERE IS NO NEED TO CHANGE THEM TO MATCH 
YOUR HARDWARE ADDRESSES. 


THIS DIRECTORY MUST BE MODIFIED IF MDISK PASSWORDS ARE TO 
BE SPECIFIED. WITHOUT MDISK PASSWORDS, MDISKS CANNOT BE 

SHARED USING THE 'CP LINK' COMMAND. A SAMPLE USER ENTRY 

FOLLOWS: (NOTE ONLY THE MDISK STATEMENT) 


* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 
USER ANYONE SOMEPASS 3M 8M FG * 
AUTOLOG AUTOLOG1 OP1 MAINT * 
ACCOUNT 22222? * 
IPL 190 * 
CONSOLE O1F 3215 * 
SPOOL @0C 2540 READER A * 
SPOOL OOD 2540 PUNCH A * 
SPOOL OOE 1403 A * 
*====>  MDISK 999 33XX XXX YYY ZZZZZZ MR RPASS WPASS MPASS  * 
* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 


t+ + £ FF FE FF HF FHF HF FF HF HF FF HF FH FF HF HF FF HF HF HF F 


WHERE: RPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 
READ ONLY MODE. 
WPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 
WRITE MODE. 
MPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 
MULTI-WRITE MODE. 


NOTE: EACH PASSWORD MAY BE 1-8 CHARACTERS IN LENGTH. 


%¥ + FF F FF F F HF F 


KKERKEKEKREEKEEKRERERERRRERREREREREREREREREEEREEREREERERRRRRERREKREKERKERK 


Following is a sample user entry and a brief description 
of each entry. A more detailed description may be found 
by referencing the VM/XA System Product Planning and 
Administration manual. 


USER CMS1 abc123 3M 32M G 
- Userid is CMS1 
- Logon password is abcl23 
- At logon time, virtual storage will equal 3M 
- Maximum storage that may be defined equals 32M 
- Privilege class is G 


+ + FH FF HF HF F H HF 
t+ + FF FF HF F HF HF HF F 
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AUTOLOG AUTOLOG1 OP1 MAINT 
- Allows user CMS1 to be autolog'd by AUTOLOG1, 
OP1, and MAINT 


ACCOUNT ACT4 CMSTST 
- Time used by CMS1 will be charged to account ACT4 
- Printed output will be sent to distribution CMSTST 


IPL CMS 
- Will cause automatic IPL of named save system of 
CMS 


CONSOLE 009 3215 
- Defines virtual machines console as a 3215 ata 
virtual address of 009 


SPOOL OOC 2540 READER A 
SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 
- Defines virtual unit record devices of reader, 
punch, and printer with a spooling class of 'A' 


LINK MAINT 190 190 RR 
- Allows read access to minidisk 190 of user 'MAINT' 


LINK MAINT 19E 19E RR 
- Allows read access to minidisk 19E of user ‘MAINT’ 


LINK MAINT 19D 19D RR 
- Allows read access to minidisk 19d of user 'MAINT' 


MDISK 999 3350 236 022 CPPACK WR RPASS WPASS 

- Defines minidisk with a virtual address of 999 

- Specifies that the minidisk resides on a real 3350 

- Minidisk starts at cylinder 236 

- Mdisk is 22 cylinders in size (starting at cyl 236 

- The real volume serial number is 'CPPACK' 

- Mdisk is to be accessed in write mode if no other 
user has write access. Alternate access read-only 

- RPASS is the required password for another user to 
link to this minidisk in read mode 

- WPASS is the required password for another user to 


link to this minidisk in write mode 
KRKEKEKEREKKKREKEKKRRKERREREKREEKRRKKKEKEKKEREKRKEKKEKRRRRREKRKKRK KKK 


te FF FF HH HF FF FF FH HF FH HF HH HF HF HF KF KF HF HF HF HF HF HF HF HF F HF HF F HF F F HF * 
+ FF FF FF FF HF HF FF HF HF KF HF HF HF FH HF HK FH KH HF HH FH KF HF HF HF HH HF F 


* 

* 

* 

DIRECTORY 123 3375 XASRES 

* 
KREEKEKREKKREREERREREREREKRERERERRERERERRRERKERERRERERKEREREKRERERERER 
* SYSTEM RESERVED AREAS NOT FOR MINIDISKS * 
KRKEREREKRKEKRKEREERKERERKERERRRKERREREREREEREREREKERERRRRREREKREE 
* 


USER $ALLOC$ NOLOG 

MDISK AQ1 3375 000 001 XASRES R 
MDISK BO1 3375 000 001 XASERV R 
MDISK COQ1 3375 000 001 XAPOO1 R 


* 


USER $DIRECT$ NOLOG 


USER DIRECT (3375) 
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USER DIRECT (3375) 


MDISK AQ4 3375 001 004 XASRES R 
* 

USER $CP-NUC$ NOLOG 

MDISK AQQ 3375 005 016 XASRES R 
* 

USER $SYSCKP$ NOLOG 

MDISK AQ6 3375 021 004 XASRES R 
* 

USER $SYSWRM$ NOLOG : 
MDISK AO7 3375 025 004 XASRES R 
* 

USER $PAGE$ NOLOG 

MDISK AQ3 3375 029 038 XASRES R 
* 

USER $SPOOL$ NOLOG 

MDISK BO1 3375 067 092 XASRES R 
te 

USER $T-DISK$ NOLOG 

MDISK BQ1 3375 561 031 XASRES R 


* 
KEEKKERKERKRRKKKEEKKEKREKRKEREREKRKEREKEKEREREREKRERKEKEEREEERERERKEREREKREE 
* CMS USERIDS * 
KKEKEKEKEKEKEREREKEKEKKEERKKEKERREKEKRRERKRERRERERERRRREREEREREREERRERREEERSE 
* 


USER CMS1 NOLOG 3M 32MG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT ACT4 CMSTST 

IPL CMS 

CONSOLE 009 3215 

SPOOL QOC 2540 READER A 
SPOOL 90D 2540 PUNCH A 
SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 


* 


KRKKKEKREREKRERKERKERRERERKEREREREKRRRREERERERRRREERERERRREEKRRERERERRERERERER 


- PROP LOGICAL OPERATOR 


KRERKEERRERKRRERERRRREKRERREREREREREREERERERERERERERREREREKRERERERRERKEREESK 


* 


USER LGLOPR NOLOG 512K 16M ABCDEG 
ACCOUNT ACT1 PROP 
IPL CMS 

CONSOLE 009 3215 

SPOOL O0C 2540 READER A 

SPOOL OOD 2540 PUNCH A 

SPOOL OOE 1403 A 

MDISK 191 3375 487 001 XASRES WR 
LINK MAINT 194 194 RR 

LINK MAINT 190 190 RR 

LINK OPERATOR 191 291 RR 


* 
KKK IK III I KIKI III III IKI IIIA IIASA IAI IK III IAI IAAI INI IAI IIIA IIIA III 
* SYSTEM RELATED USERIDS * 
KREKEKEEKEEKERERERERKRERERERREREKRRERERERERERERERRERERREERERERRRREEKKREEE 
* 


USER MAINT NOLOG 16M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 1 SYSPROG 
IPL 190 
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NAMESAVE GCS 
NAMESAVE VTAM 
NAMESAVE HELP 
NAMESAVE INSTHELP 
CONSOLE 009 3215 T 


SPOOL 
SPOOL 
SPOOL 
MDISK 
MDISK 
MDISK 
* 
MDISK 
MDISK 
MDISK 
MDISK 
* 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 


MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 


MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
* 
MDISK 
MDISK 
MDISK 
* 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 


* 


00C 
00D 
OOE 
123 
124 
125 


191 
193 
194 
201 


192 
392 
492 
692 
594 
593 
423 


295 
395 
495 
592 
892 
491 
791 
B9E 
896 
895 


293 
294 
393 
394 
19C 
49C 
596 
59E 


190 
19E 
19D 


291 
391 
591 
691 
49D 
490 
501 
595 


2540 
2540 


READER * 
PUNCH A 


1403 A 


3375 
3375 
3375 


3375 
3375 
3375 
3375 


3375 
3375 
3375 
3375 
3375 
3375 
3375 


3375 
3375 
3375 
3375 
3375 
3375 
3375 
3375 
3375 
3375 


3375 
3375 
3375 
3375 
3375 
3375 
3375 
3375 


3375 
3375 
3375 


3375 
3375 
3375 
3375 
3375 
3375 
3375 
3375 


000 
000 
000 


671 
742 
818 
067 


102 
126 
150 
166 
182 
276 
339 


492 
44] 
434 
442 
458 
466 
482 
498 
514 
530 


589 
683 
001 
748 
173 
219 
265 
297 


223 
313 
382 


336 
159 
428 
522 
585 
631 
744 
546 


959 
959 
959 


Q25 
076 
082 
035 


024 
024 
016 
016 
094 
063 
016 


047 
032 
008 
016 
008 
016 
016 
016 
016 
016 


094 
125 
088 
204 
046 
046 
032 
016 


113 
069 
046 


094 
063 
094 
063 
046 
113 
004 
020 


XASRES 
XAPOOQ1 
XASERV 


XASRES 
XASRES 
XASRES 
XASERV 


XASERV 
XASERV 
XASERV 
XASERV 
XASERV 
XASERV 
XASERV 


XASRES 
XASRES 
XASERV 
XASERV 
XASERV 
XASERV 
XASERV 
XASERV 
XASERV 
XASERV 


XASERV 
XASERV 
XAPOO1 
XAPOO1 
XAPQO1 
XAPOO1 
XAPOO1 
XAPOO1 


XASRES 
XAPQO1 
XAPOO1 


XASRES 
XASRES 
XAPOO1 
XAPOQO1 
XAPQO1 
XAPOO1 
XAPOO1 
XASERV 


USER DIRECT (3375) 


RMAINT WMAINT MMAINT 
READ 
READ 
READ 
READ 
READ 


READ 


WRITE 
WRITE 
WRITE 
WRITE 
WRITE 
WRITE 


MULTIPLE 
MULTIPLE 
MULTIPLE 
MULTIPLE 
MULTIPLE 
MULTIPLE 


MULTIPLE 
MULTIPLE 
MULTIPLE 
MULTIPLE 
MULTIPLE 
MULTIPLE 


READ 
READ 
READ 
READ 
READ 
READ 


WRITE 
WRITE 
WRITE 
WRITE 
WRITE 
WRITE 


WRITE 
WRITE 
WRITE 


MULTIPLE 
MULTIPLE 
MULTIPLE 


READ 
READ 
READ 


RCMSAUX WCMSAUX MCMSAUX 
RCPAUX WCPAUX MCPAUX 


ALL 
ALL 
ALL 


READ WRITE MULTIPLE 
READ WRITE MULTIPLE 
READ WRITE MULTIPLE 


READ WRITE MULTIPLE 
READ WRITE MULTIPLE 


* MDISK STATEMENTS FOR INSTALL & SERVICE OF RSCS & PASS-THROUGH 


MDISK 36E 3375 089 004 XAPOO1 RR RPVM 


WPVM MPVM 
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USER DIRECT (3375) 


LINK RSCS 191 499 MW 
* 
USER CMSBATCH NOLOG 1M 2M G 
ACCOUNT 3 SYSTEM 
OPTION ACCT 
IPL CMS PARM AUTOCR 
CONSOLE 909 3215 
SPOOL O0C 2540 READER * 
SPOOL 00D 2540 PUNCH A 
SPOOL QGE 1403 A 
LINK MAINT 190 19 RR 
MDISK 195 3375 488 004 XASRES MR RBATCH WBATCH MBATCH 
* 
USER GCS NOLOG 16M 16M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT GCS RECVM 
IPL GCS 
NAMESAVE GCS 
CONSOLE 009 3215 ff 
SPOOL OOC 2540 READER * | 
SPOOL 00D 2540 PUNCH A 
SPOOL OOF 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19D 19D RR 
LINK MAINT 595 595 
LINK MAINT 59E 59E 
MDISK 191 3375 441 006 XASRES MR RGCS WGCS MGCS 
P | 
USER SYSMAINT NOLOG 3M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT | CO 
ACCOUNT 1 SYSPROG al 
IPL CMS 
CONSOLE 909 3215 T 
SPOOL OOC 2540 READER * 
SPOOL @@D 2540 PUNCH A 
SPOOL QOE 1403 A 
LINK MAINT 123 123 MW 
LINK MAINT 191 192 RR 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR = 
* 
USER OPERATOR NOLOG 16M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 2 OPERATOR 
CONSOLE 009 3215 T 
SPOOL O0C 2540 READER * 
SPOOL 00D 2540 PUNCH A 
SPOOL QOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 191 3375 696 008 XASRES MR 
LINK OP1 191 192 RR 


* 


*OP1 IS AN ALTERNATE OPERATOR USERID 
* 

USER OP1 NOLOG 3M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 

ACCOUNT 3 OPERATOR 


\ 


> ee oo 
£ 
AN 
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USER DIRECT (3375) 


IPL CMS 
CONSOLE 009 3215 
_. SPOOL O0C 2540 READER * 

( SPOOL GOD 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 191 3375 704 002 XASRES MR 
LINK OPERATOR 191 192 RR 


This userid is for the IBM CE's use in running 
OLTSEP. 

OLTSEP is automatically IPLed in the virtual machine. 
A minimum machine size of one megabyte is required to 
run OLTSEP. 

The privilege class of F allows the CE to specify 
intensive recording mode. 

The console address of 01F is required by OLTSEP. 

The unit record addresses are those required by 
OLTSEP. 

The 5FF minidisk is the CE's OLTSEP pack. 


+ £ €* € + FF FF F FE FHF HF HF F 


USER OLTSEP NOLOG 3M 8M FG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT OLTSEP IBMCE 
IPL 5FF 
CONSOLE O1F 3215 
a SPOOL OC 2540 READER A 
( ae SPOOL 00D 2540 PUNCH A 
coe SPOOL OGE 1403 A 
MDISK 5FF 3375 000 959 CEPACK MR 


*K* FREP Kk 


This userid is for the IBM CE's use in running 
CPEREP. 

CMS is automatically IPLed in the virtual machine. 
The 190 minidisk is the CMS system disk. 

The 191 minidisk may be used to save often-used EREP 
control statements and procedures (EXECs). 

THE 190 MINIDISK HAS THE CMS TXTLIBS NECESSARY TO RUN 
EREP. 


+ % + + FF HF FF HF * 


USER EREP NOLOG 3M 8M BFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT EREP IBMCE 
IPL CMS 
CONSOLE O1F 3215 
SPOOL OOC 2540 READER A 
SPOOL GOD 2540 PUNCH B 
SPOOL OGE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 201 201 RR 
MDISK 191 3375 738 004 XASRES WR READ WRITE MULTIPLE 
* 
ae USER OPERATNS NOLOG 3M 8M BCEG 
( j AUTOLOG AUTOLOG1 OP1 MAINT 
7 ACCOUNT 1 OPERATNS 
IPL CMS 


Appendix C. VM/XA System Product Starter System Information 791 


USER DIRECT (3375) 


CONSOLE 009 3215 

SPOOL OOC 2540 READER D 

SPOOL OOD 2540 PUNCH A 

SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

MDISK 191 3375 706 026 XASRES MR RDVF WDVF MDVF 


* 
* 


USER IPCS NOLOG 3M 8M BCEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 8 CE-ROOM 

IPL CMS 
CONSOLE 009 3215 
SPOOL @O0C 2540 READER * 
SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 190 190 RR se 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR ‘ea, 
LINK OPERATNS 193 192 RR 

* 

USER AUTOLOG1 NOLOG 3M 8M ABCDEG 
AUTOLOG OP1 MAINT 
ACCOUNT 9 SYSTEM 

IPL CMS 

CONSOLE 009 3215 
SPOOL O0C 2540 READER * 

SPOOL 00D 2540 PUNCH A | es 
SPOOL OOE 1403 A \ 
LINK MAINT 190 190 RR 
MDISK 191 3375 732 002 XASRES MR RAUTOLOG WAUTOLOG MAUTOLOG 

* 

USER DISKACNT NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 10 ACCNTNG 

IPL CMS 

CONSOLE 009 3215 
SPOOL Q@C 2540 READER * 
SPOOL 00D 2540 PUNCH A — 
SPOOL OOE 1403 A See 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 191 3375 734 @@2 XASRES MR READ WRITE MULTIPLE 

* 

USER IBMPSR NOLOG 3M 8M BG 
ACCOUNT 10 ACCNTNG 

IPL CMS 

CONSOLE 009 3215 
SPOOL O0C 2540 READER * 

SPOOL 00D 2540 PUNCH A 
SPOOL O0E 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 191 3375 736 002 XASRES WR 


* 


USER IVPM2 NOLOG 3M 4MG 


792 Installation and Service 


USER DIRECT (3375) 


AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT ACTS IVPM2 
CONSOLE 009 3215 
SPOOL OOC 2540 READER A 
SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 194 194 RR 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 

* 

USER VMUTIL NOLOG 3M 8M BDEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 11 SYSTEM 

IPL CMS 
CONSOLE 009 3215 
SPOOL O@C 2540 READER * 
SPOOL O@D 2540 PUNCH A 
oo SPOOL OOE 1403 A 
( LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
* 
USER SYSDUMP1 NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 12 SYSTEM 
IPL CMS 
CONSOLE 009 3215 
— SPOOL O0C 2540 READER * 

( ; SPOOL GOD 2540 PUNCH A 

bin SPOOL OOF 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19£ 19E RR 
LINK MAINT 19D 19D RR 
MDISK 123 3375 000 959 XASRES RR 
MDISK 124 3375 000 959 XAPQOQ1 RR 
MDISK 125 3375 000 959 XASERV RR 


* 


* 


P USER RSCS NOLOG 3M 8M BEG 
( | AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 13 SYSTEM 
NOPDATA 
IPL 191 


CONSOLE 009 3215 

SPOOL GOC 2540 READER * 

SPOOL OOD 2540 PUNCH A 

SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

MDISK 191 3375 553 Q04 XASRES MR RRSCS WRSCS MRSCS 
* 
USER PVM NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 14 SYSTEM 


( * IPL CMS 

ok CONSOLE 009 3215 
SPOOL OC 2540 READER * 
SPOOL OOD 2540 PUNCH A 
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USER DIRECT (3375) 


SPOOL QOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
LINK MAINT 36E 191 MR 


* 

* 

KKKRKKEKK KEKE REE EERE KK EKER EKER ERE KERR EK EREKREKREREKREREREREKRERKEEEK 
* OTHER OPERATING SYSTEM USERIDS * 
KEKKEREKRERREREREKEEEREKRREREREKREREKEKRKRKEKRERERREKRERRRERREREREKRERKE 


* 
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XAMAINT Directory Entry (3375) 


Sample XAMAINT Directory Entry for 3375 


If you are using the procedure in Chapter 4, “Installing VM/XA System Product Release 2 Using an Existing 
VM/SP or VM/SP HPO System” on page 219 to install your system, add the following entry to your 
directory: 


* 


USER XAMAINT NOLOG 16M 16M ABCDEFG 
OPTION ECMODE DIAG98 
ACCOUNT 1 SYSPROG 
IPL 190 
*NAMESAVE GCS 
*NAMESAVE VTAM 
*NAMESAVE HELP 
*NAMESAVE INSTHELP 
CONSOLE 009 3215 T 
SPOOL OOC 2540 READER * 
SPOOL OOD 2540 PUNCH A 
fo. SPOOL OOE 1403 A 
( MDISK 123 3375 000 959 XASRES MW 
MDISK 124 3375 000 959 XAPO01 RR 
MDISK 125 3375 000 959 XASERV RR 
* 
MDISK 191 3375 671 025 XASRES MW 
MDISK 193 3375 742 076 XASRES MW 
MDISK 194 3375 818 Q82 XASRES MW 
MDISK 201 3375 067 035 XASERV MW RMAINT WMAINT MMAINT 
* 
ee MDISK 192 3375 102 024 XASERV MW READ WRITE MULTIPLE 
( \ MDISK 392 3375 126 024 XASERV MW READ WRITE MULTIPLE 
MDISK 492 3375 150 016 XASERV MW READ WRITE MULTIPLE 
MDISK 692 3375 166 016 XASERV MW READ WRITE MULTIPLE 
MDISK 594 3375 182 094 XASERV MW READ WRITE MULTIPLE 
MDISK 593 3375 276 063 XASERV MW READ WRITE MULTIPLE 
MDISK 423 3375 339 016 XASERV MW 


MDISK 295 3375 492 047 XASRES MW READ WRITE MULTIPLE 
MDISK 395 3375 447 032 XASRES MW READ WRITE MULTIPLE 
MDISK 495 3375 434 008 XASERV MW READ WRITE MULTIPLE 
c. MDISK 592 3375 442 016 XASERV MW READ WRITE MULTIPLE 
( MDISK 892 3375 458 Q08 XASERV MW READ WRITE MULTIPLE 
MDISK 491 3375 466 016 XASERV MW READ WRITE MULTIPLE 
MDISK 791 3375 482 016 XASERV MW 
MDISK 89E 3375 498 016 XASERV MW READ WRITE MULTIPLE 
MDISK 896 3375 514 016 XASERV MW READ WRITE MULTIPLE 
MDISK 895 3375 530 016 XASERV MW READ WRITE MULTIPLE 


MDISK 293 3375 589 094 XASERV MW RCMSAUX WCMSAUX MCMSAUX 
MDISK 294 3375 683 125 XASERV MW RCPAUX WCPAUX MCPAUX 
MDISK 393 3375 001 088 XAPQ01 WR 

MDISK 394 3375 748 204 XAPOO1 WR 

MDISK 19C 3375 173 046 XAPOOQ1 WR 

MDISK 49C 3375 219 046 XAPOOQ1 WR 

MDISK 596 3375 265 032 XAPOOQ1 WR 

MDISK 59E 3375 297 016 XAPOO1 WR 

* 

MDISK 190 3375 223 113 XASRES MW ALL 

MDISK 19E 3375 313 069 XAPOO1 MW ALL 

MDISK 19D 3375 382 046 XAPOO1 MW ALL 


* 
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XAMAINT Directory Entry (3375) 


MDISK 291 
MDISK 391 
MDISK 591 
MDISK 691 
MDISK 49D 
MDISK 490 
MDISK 501 
MDISK 595 


* 


* MDISK STATEMENTS FOR INSTALL & SERVICE OF RSCS & PASS-THROUGH 


3375 
3375 
3375 
3375 
3375 
3375 
3375 
3375 


336 
159 
428 
522 
585 
631 
744 
546 


Q94 XASRES 
Q63 XASRES 
Q94 XAP001 
063 XAPOO1 
046 XAPO01 
113 XAPOQ1 
004 XAPOQ01 
Q@20 XASERV 


MW 
MW 


MW READ WRITE MULTIPLE 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 


MDISK 36£ 3375 089 004 XAPOOQ1 RR RPVM WPVM MPVM 
LINK RSCS 191 499 MW 
LINK MAINT 190 390 RR 


* 
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Soa ot 


XASRES Volume Allocation (3375) 


System Residence DASD Allocation for 3375 


Figure 56 shows the allocation for the system residence device for the 3375 VM/XA SP starter system. 


TYPE CYL CYL 
PERM 000-000 
DRCT 001-003 
PERM 004-018 
PAGE 019-054 
SPOL 055-113 
PERM 114-306 
TDSK 307-336 
PERM 337-958 


Figure 56. System Residence DASD Allocation for 3375 
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Minidisk Maps (3375) 


Minidisk Maps for 3375 System Residence Device 


Figure 57 shows the minidisk maps of the system residence device for the 3375. To map your own system 
residence device for comparison, issue DISKMAP fn DIRECT, where fn is the name of your directory. 


VOLUME USERID CUU DEVTYPE START END SIZE 
CEPACK OLTSEP 5FF 3375 0000 0958 0959 
VOLUME USERID CUU  DEVTYPE START END SIZE 
XAPOO1  $ALLOC$ C01 3375 0000 0000 0001 
MAINT 393 3375 0001 0088 0088 
MAINT 36E 3375 0089 0092 0004 
93 172 80 GAP a 
MAINT 19¢ 3375 01723 0218 9046 od 
MAINT 49C 3375 0219 0264 0046 > 
MAINT 596 3375 0265 0296 0032 
MAINT 59E 3375 0297 0312 0016 
MAINT 19E 3375 0313 0381 0069 
MAINT 19D 3375 0382 0427 0046 
MAINT 591 3375 0428 0521 0094 
MAINT 691 3375 0522 0584 0063 
MAINT 49D 3375 0585 0630 0046 
MAINT 490 3375 0631 0743 0113 Pat 
MAINT 501 3375 0744 0747 0004 a 
MAINT 394 3375 0748 0951 0204 ee 
MAINT 124 3375 0000 0958 0959 **OVERLAP** 
SYSDUMP1 124 3375 0000 0958 0959 **OVERLAP** 
VOLUME USERID CUU  DEVTYPE START END SIZE 
XASERV $ALLOC$ B01 3375 0000 0000 0001 
1 66 66 GAP | 
MAINT 201 3375 0067 0101 0035 —_— 
MAINT 192 3375 0102 0125 0024 rs 
MAINT 392 3375 0126 0149 0024 
MAINT 492 3375 0150 0165 0016 
MAINT 692 3375 0166 0181 0016 
MAINT 594 3375 0182 0275 0094 
MAINT 593 3375 0276 0338 0063 
MAINT 423 3375 0339 0354 0016 
355 433 79 ~—«GAP 


Figure 57 (Part 1 of 3). Minidisk Maps of the System Residence Device for 3375 
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Minidisk Maps (3375) 


MAINT 495 3375 0434 0441 0008 | 2 
MAINT 592 3375 0442 0457 0016 

MAINT 892 3375 0458 0465 0008 

MAINT 491 3375 0466 0481 0016 

MAINT 791 3375 0482 0497 0016 

MAINT 89E 3375 0498 0513 0016 

MAINT 896 3375 0514 0529 0016 

MAINT 895 3375 0530 0545 0016 

MAINT 595 3375 0546 0565 0020 

566 588 23 GAP 

MAINT 293 3375 0589 0682 0094 

MAINT — 294 3375 0683 0807 0125 

MAINT 125 3375 0000 0958 0959 **OVERLAP** 


SYSDUMP1 125 3375 0000 0958 0959 **OVERLAP** 


le VOLUME USERID CUU = DEVTYPE START END SIZE 
( XASRES  $ALLOC$ A01 3375 0000 0000 0001 
ae $DIRECT$ A04 3375 0001 0004 0004 


$CP-NUC$ AOS 3375 0005 0920 0016 
$SYSCKP$  A06 3375 0021 0024 0004 
$SYSWRM$ AQ7 3375 0025 9028 0004 


$PAGE$ AQ3 3375 0029 0066 0038 
$SPOOL$ BOl 3375 0067 0158 0092 
MAINT 39] 3375 0159 0221 0063 
222 222 1 GAP 
MAINT 190 3375 0223 0335 0113 
a— MAINT 291 3375 0336 0429 0094 
( 430 440 11 GAP 
GCS 191 3375 0441 0446 0006 
MAINT 395 3375 0447 0478 0032 
479 486 8 GAP 
LGLOPR 191 3375 0487 0487 0001 
CMSBATCH 195 3375 0488 0491 0004 
MAINT 295 3375 0492 0538 0047 
539 552 14 GAP 
RSCS 191 3375 0553 0556 0004 
557 560 4 GAP 
( | Figure 57 (Part 2 of 3). Minidisk Maps of the System Residence Device for 3375 
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Minidisk Maps (3375) 


$T-DISK$ BOl 3375 0561 0591 0031 


592 670 79 GAP 
MAINT 191 3375 0671 0695 0025 
OPERATOR 191 3375 0696 0703 0008 
OP1 191 3375 0704 0705 0002 


OPERATNS 191 3375 0706 0731 0026 
AUTOLOG1 191 3375 0732 0733 0002 
DISKACNT 191 3375 0734 0735 0002 


IBMPSR 191 3375 0736 0737 0002 
EREP 191 3375 0738 0741 0004 
MAINT 193 3375 0742 0817 0076 
MAINT 194 3375 0818 0899 0082 
MAINT 123 3375 0000 0958 0959 **OVERLAP** 


SYSDUMP1 123 3375 0000 0958 0959 **OVERLAP** 


Figure 57 (Part 3 of 3). Minidisk Maps of the System Residence Device for 3375 
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HCPSYS ASSEMBLE (3380) 


Sample Files for 3380 Starter System 


IBM provides the following sample files with the VM/XA SP 3380 Starter System: 


HCPSYS ASSEMBLE for Starter System 

¢ System directories for 3380, 3380-E4, and 3380-K 
e System residence DASD allocation 

e Minidisk maps of the system residence device. 


Sample HCPSYS ASSEMBLE for 3380 


This is only a sample file. You need to tailor it to your installation before it can be used. 
SYS TITLE 'HCPSYS8Q - HCPSYS FOR VM/XA INSTALL BUILD' 


KKEKEKEKKEEKEKEREKREEREKREREREKEEKERKREKERERKERREERRERERKEEK ERK RR KEEKKEREEKKKKE 


* THIS MODULE IS RESTRICTED MATERIALS OF IBM. . 
* 5664-308 (C) COPYRIGHT IBM CORPORATION - 1988 * 
* LICENSED MATERIALS - PROPERTY OF IBM : 
* SEE COPYRIGHT INSTRUCTIONS, G120-2083 e 


KEKKEKKEREKRREREKRRRERKEKREEKRREREREEEKREREKEREREREREREEEERREREREREKREREEKRKKKRKKRKKKE 


KKEKKEKKEKKEKEKKEKEREKRKEEKKKEREREKREKEKREREKRREREREEKERKREKRERERKRERKKKEE 


MODULE NAME - HCPSYS 


DESCRIPTIVE NAME - DEFINITION OF SYSTEM 
FUNCTION - TO DEFINE THE SYSTEM 


REGISTER CONVENTIONS - SYMBOLIC REFERENCES TO REGISTERS ARE 
OF THE FORM "RX" WHERE X IS A NUMBER 
RANGING FROM 0 TO 15 (SEE HCPEQUAT COPY) 
PATCH LABEL - NONE 
MODULE TYPE - DATA 
PROCESSOR - ASSEMBLER H (VERSION 2) 
ATTRIBUTES - RESIDENT, DATA-ONLY 
MACROS - 


SYSSTORE - DEFINE SYSTEM REAL STORAGE 


SYSRES DEFINE SYSTEM RESIDENCE VOLUME 
SYSCPVOL - DEFINE SYSTEM VOLUMES 

SYSOPR DEFINE SYSTEM OPERATOR 

SYSTIME DEFINE THE TIME ZONE 

SYSACNT DEFINE ACCOUNTING USERID 

SYSDUMP DEFINE DUMP RECEIVER USERID 
SYSEREP DEFINE EREP RECEIVER USERID 

SYSID DEFINE SYSTEM ID'S BY PROCESSOR 
SYSUVOL DEFINE USER VOLUMES TO BE MOUNTED 
SYSFCN DEFINE PRIV CLASSES ASSIGNED TO CP FUNCTIONS 
SYSEND END SYSTEM GENERATION 
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HCPSYS ASSEMBLE (3380) 


* GENERAL COMMENTS - THIS MODULE IS THE USER'S RESPONSIBILITY. 


* 
KKKEKKKKEKEKERERKEKKKKREKRREREERERERERERERRRERREKRRERRERRERREERERRERERREERRREERRERER 


SPACE 1 


* THE SYSTEM DEFINITION MACROS SYSSTORE, SYSRES, SYSCPVOL, 
* SYSOPR, AND SYSTIME, ARE CODED HERE, IN ANY ORDER 
SPACE 1 
SYSSTORE RMSIZE=32M, VRSIZE=8M, VRFREE=256 
SYSRES SYSVOL=XASRES, 
SYSRES=123 , SYSTYPE=3380, 
SYSNUC=003, : 
SYSCKP=(013,2) , 
SYSWRM=(015,2) 
SYSTIME ZONE=5,LOC=WEST, ID=EST 
SYSOPR SYSOPER=OPERATOR 
SYSCPVOL _ XASRES,XASERV,XAP001, « 
DRUMO1,DRUMO2 , DRUMO3 , DRUMO4 , DRUMO5 , DRUMO6 , DRUMO7, * 
PAGOO1, PAGOO2 , PAGOO3, PAGOO4 , PAGOOS , PAGO06 , PAGOO7 , * oN 
SPLOO1,SPLOA2 , SPI.A03,SPLAN4,SPLAN5, SPLOQ6, SPLOO7 — 
SPACE 1 


%¥ + 


* ANY OF THE OPTIONAL MACROS THAT ARE DESIRED ARE CODED HERE, 
* IN ANY ORDER | 

SPACE 1 

SYSID DEFAULT=INSTTST, (3081A, 3081, 10000) 

SYSACNT USERID=DISKACNT 

SYSDUMP USERID=OPERATNS 

SYSEREP USERID=EREP ; 

SYSUVOL USRPO1, USRPO2 , USRPO3, USRPO4 , USRPO5 , USRPO6, USRPO7 , * 7 

USRPO8 , USRPOQ9 
SYSFCN OPER=A,CPRD=CE,CPWT=C,SERV=F ,DFLT=G 
SPACE 1 


SPACE 1 
SYSEND 
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USER DIRECT (3380) 


There are three sets of sample directory, minidisk allocations, and minidisk maps for different models of 3380 


DASD. The first set (“Sample Directory for 3380,” “System Residence DASD Allocation for 3380” on 
page 814, and “Minidisk Maps for 3380 System Residence Device” on page 815) is for the 3380. The 


second set (“Sample Directory for 3380-E4” on page 817, “System Residence DASD Allocation for 3380-E4” 
on page 828, and “Minidisk Maps for 3380-E4 System Residence Device” on page 829) is for the 3380-E4. 


The third set (“Sample Directory for 3380-K” on page 832, “System Residence DASD Allocation for 


3380-K” on page 843, and “Minidisk Maps for 3380-K System Residence Device” on page 844) is for the 


3380-K. 


Sample Directory for 3380 


This is only a sample file. You need to tailor it to your installation before it can be used. 


KKEKKEKEKKKKREREKKEKRERERERERERKERRRERKREREKREREREKEEKRREREKRREKREKREEREKRE 


nee Virtual Machine / System Product 5664-308 ae 
ae Contains restricted materials of IBM ake 
we Copyright (c) I BM Corporation 1988 AeE 
eae Licensed Materials - Property of I BM APS 


Eee Refer to Copyright Instructions: Form G120-2083 ane 


KREKEREKKKEEKEEKERRKREKRKKEREREKREKEREREREKERARRKEERERERRRREKERRKRKEREKRKE 


KREKKEKEKEKREKEREKEERKEKREREREKRREEKKEKRRREKRERERREEKREREERRRREKKKKRKKREK 


3380 SYSTEM VM/XA SYSTEM PRODUCT DIRECTORY 

THE ADDRESSES 123, 124, AND 125 ARE VIRTUAL ADDRESSES. 

THE ADDRESS 123 IS CRITICAL SINCE IT IS USED IN HCPSYS AND 
THE DIRECTORY. IF YOU WANT TO CHANGE IT, REMEMBER IT MUST 
BE CHANGED IN HCPSYS, THE ‘DIRECTORY’ STATEMENT BELOW, 

AND IN THE 'MDISK' STATEMENTS FOR THE USERID ‘MAINT’. 
NOTE: REMEMBER THESE ARE ONLY VIRTUAL ADDRESSES NOT REAL 
ADDRESSES, SQ THERE IS NO NEED TO CHANGE THEM TO MATCH 
YOUR HARDWARE ADDRESSES. 


THIS DIRECTORY MUST BE MODIFIED IF MDISK PASSWORDS ARE TO 
BE SPECIFIED. WITHOUT MDISK PASSWORDS, MDISKS CANNOT BE 

SHARED USING THE 'CP LINK' COMMAND. A SAMPLE USER ENTRY 

FOLLOWS: (NOTE ONLY THE MDISK STATEMENT) 


USER ANYONE SOMEPASS 3M 8M FG 
AUTOLOG AUTOLOG1 OP1 MAINT 


IPL 190 

CONSOLE O1F 3215 

SPOOL OOC 2540 READER A 

SPOOL QOD 2540 PUNCH A 

SPOOL QOOE 1403 A 

MDISK 999 33XX XXX YYY ZZZZZZ MR RPASS WPASS MPASS 


+ + €£$ + FF + FF F HF F HF HF FH HF FF HF HF FHF HF HF HF HF F 


+ 
{ 
I 
1 
I 

Vv 


WHERE: RPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 
READ ONLY MODE. 
WPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 
WRITE MODE. 
MPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 
MULTI-WRITE MODE. 


NOTE: EACH PASSWORD MAY BE 1-8 CHARACTERS IN LENGTH. 


+ F t+ + FF FF HF F F HF HF HF HF F HF F HF HF FHF HF HF HF FF HF HF KF F KF HF * 


+ €+ + + FF $F F FF HF F 


KRRKEKEEKKEKEERKEREREEREREEKREKERRRERREKEKEKEKERKR EKER KRKERREKEREREREERE 
* * 
* * 


* Following is a sample user entry and a brief description * 
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USER DIRECT (3380) 


* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 


of each entry. A more detailed description may be found 
by referencing the VM/XA System Product Planning and 
Administration manual. : | 


USER CMS1 abci23 3M 32M G 


- Userid is CMS1 

- Logon password is abcl23 

- At logon time, virtual storage will equal 3M 

- Maximum storage that may be defined equals 32M 
- Privilege class is G 


AUTOLOG AUTOLOG1 OP1 MAINT 
- Allows user CMS1 to be autolog'd by AUTOLOG1, 
OP1, and MAINT 


ACCOUNT ACT4 CMSTST 
- Time used by CMS1 will be charged to account ACT4 


- Printed output will be sent to distribution CMSTST 


IPL CMS 


CONSOLE 009 3215 
- Defines virtual machines console as a 3215 ata 
virtual address of 009 


SPOOL OOC 2540 READER A 
SPOOL OOD 2540 PUNCH A 
SPOOL QOE 1403 A 
- Defines virtual unit record devices of reader, 
punch, and printer with a spooling class of ‘A’ 


LINK MAINT 190 190 RR 


-~ Allows read access to minidisk 190 of user 'MAINT' 


LINK MAINT 19E 19E RR 


- Allows read access to minidisk 19E of user 'MAINT' 


LINK MAINT 19D 19D RR 


- Allows read access to minidisk 19d of user '‘MAINT' 


MDISK 999 3350 236 022 CPPACK WR RPASS WPASS 
- Defines minidisk with a virtual address of 999 


- Specifies that the minidisk resides on a real 3350 


- Minidisk starts at cylinder 236 


- Mdisk is 22 cylinders in size (starting at cyl 236 


- The real volume serial number is 'CPPACK' 


- Mdisk is to be accessed in write mode if no other 
user has write access. Alternate access read-only 
- RPASS is the required password for another user to 


link to this minidisk in read mode 


- WPASS is the required password for another user to 


link to this minidisk in write mode 


+e ee HK HK HF HE HK HF FF HF HF HK KF HF HF HF HF HF HF HF HF HF HF HK HF HF HF HE HF KF HF HF HF HF HF HF HF HF HF HF HF HF HF HF HF HF H 


KEKRKEKEREKRERRREREERRRRERRERRRERERERERERREREKERRRRERREREKERERERERREE 


* 
* 
* 


DIRECTORY 123 3380 XASRES 


* 
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USER DIRECT (3380) 


II IIT RIO AR AOKI IR IIT I TTR TAIT IE ICTR II TIT TAI III II IIA IAI AEA IK 
> SYSTEM RESERVED AREAS NOT FOR MINIDISKS : 
II III II TOR TOR II RK II TTI IRR IORI II III I TO TO TT RII TOR II I TIA KI IRI IIA 


* 


USER $ALLOC$ NOLOG 

MDISK AQ1 3380 000 001 XASRES R 

MDISK BO1 3380 000 001 XASERV R 

MDISK C01 3380 000 001 XAPOQ1 R 

* 

USER $DIRECT$ NOLOG 

MDISK AO4 3380 001 002 XASRES R 
* 

USER $CP-NUC$ NOLOG 

MDISK AQ9 3380 003 010 XASRES R 
* 

USER $SYSCKP$ NOLOG 

MDISK AQ6 3380 013 002 XASRES R 
* 

USER $SYSWRM$ NOLOG 

MDISK AQ7 3380 015 002 XASRES R 
* 

USER $PAGE$ NOLOG 

MDISK AO3 3380 017 024 XASRES R 

* 

USER $SPOOL$ NOLOG 

MDISK BO1 3380 041 087 XASRES R 

* 

USER $T-DISK$ NOLOG 

MDISK BQ1 3380 539 020 XASRES R 


* 
KKRKEEREEKEREERRRERERRKEKE KERR EREKEREREERRERERERREKRKRREREKEREREKERER 
* CMS USERIDS * 
KKEKKEKERKERERERKERKEKEKRKEREKREREKRERERKRKERERRERERERKEREKREERERER 
* 


USER CMS1 NOLOG 3M 32MG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT ACT4 CMSTST 

IPL CMS 

CONSOLE 009 3215 

SPOOL OOC 2540 READER A 
SPOOL QOD 2540 PUNCH A 
SPOOL QOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 


* 
KKEKREKRERERERERREKEKRERERERERERREREERRREKREREKEKEREEREREREKRERKREKRREKREEKREREKKRE 
* PROP LOGICAL OPERATOR * 
KREKEKREEREKEKREKEKREREREKEREKEKREEREKKEKRKKRKEREKREREREKRERREKRRKEKERERKKKKKE 
* 


USER LGLOPR NOLOG 512K 16M ABCDEG 
ACCOUNT ACTI PROP 
IPL CMS 
CONSOLE 009 3215 
SPOOL OOC 2540 READER A 
SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 
MDISK 191 3380 493 001 XASRES WR 
LINK MAINT 194 194 RR 
LINK MAINT 190 190 RR 
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USER DIRECT (3380) 


LINK OPERATOR 191 291 RR 


* 
KKKEREKKREKRERERERKREREREREREREREREERERREERERREKERRERERERRRERRRREER 


. SYSTEM RELATED USERIDS - 


KEKRERKERKRKEKKERERRRERERERRERERERERRERERERERRRERERERRERKREKRERRRRRREERR 


* 


USER MAINT NOLOG 16M 32M ABCDEFG 

AUTOLOG AUTOLOG1 OP1 MAINT 

ACCOUNT 1 SYSPROG 

IPL 190 

NAMESAVE GCS 

NAMESAVE VTAM 

NAMESAVE HELP 

NAMESAVE INSTHELP 

CONSOLE 009 3215 T 

SPOOL O0C 2540 READER * 

SPOOL OOD 2540 PUNCH A 

SPOOL QOE 1403 A 

MDISK 123 3380 000 885 XASRES MW 7 
MDISK 124 3380 Q0Q 885 XAPOQ1 RR eo * 


MNTCIL ANF ANAAN ANN AnaALr err. ar 


MULON ico 3300 GOU 865 AASERV RR 


MDISK 191 3380 703 016 XASRES MW 
MDISK 193 3380 128 046 XASRES MW 
MDISK 194 3380 747 056 XASRES MW 
MDISK 201 3380 043 022 XASERV MW RMAINT WMAINT MMAINT 


MDISK 192 3380 065 015 XASERV MW READ WRITE MULTIPLE 

MDISK 392 3380 080 015 XASERV MW READ WRITE MULTIPLE 

MDISK 492 3380 095 010 XASERV MW READ WRITE MULTIPLE fete 
MDISK 692 3380 105 010 XASERV MW READ WRITE MULTIPLE \ 
MDISK 594 3380 115 060 XASERV MW READ WRITE MULTIPLE 

MDISK 593 3380 175 040 XASERV MW READ WRITE MULTIPLE 


MDISK 295 3380 559 030 XASRES MW READ WRITE MULTIPLE 

MDISK 395 3380 589 Q20 XASRES MW READ WRITE MULTIPLE 

MDISK 495 3380 265 005 XASERV MW READ WRITE MULTIPLE 

MDISK 592 3380 270 010 XASERV MW READ WRITE MULTIPLE 

MDISK 892 3380 280 005 XASERV MW READ WRITE MULTIPLE 

MDISK 491 3380 285 010 XASERV MW READ WRITE MULTIPLE 

MDISK 791 3380 295 010 XASERV MW READ WRITE MULTIPLE | f 
MDISK 89E 3380 305 010 XASERV MW READ WRITE MULTIPLE | Ye 
MDISK 896 3380 315 010 XASERV MW READ WRITE MULTIPLE 

MDISK 895 3380 325 010 XASERV MW READ WRITE MULTIPLE 


MDISK 490 3380 362 Q72 XASERV MW 
MDISK 423 3380 434 010 XASERV MW 
MDISK 293 3380 444 060 XASERV MW RCMSAUX WCMSAUX MCMSAUX 
MDISK 294 3380 504 080 XASERV MW RCPAUX WCPAUX MCPAUX 
MDISK 393 3380 389 056 XASRES WR 
MDISK 394 3380 584 130 XASERV WR 
MDISK 19C 3380 763 029 XASERV WR 
MDISK 49C 3380 792 029 XASERV WR 


MDISK 291 3380 803 060 XASRES MW 
MDISK 391 3380 215 040 XASERV MW 
MDISK 591 3380 821 060 XASERV MW READ WRITE MULTIPLE 
MDISK 691 3380 306 040 XASRES MW READ WRITE MULTIPLE 
MDISK 49D 3380 346 029 XASRES MW READ WRITE MULTIPLE 
MDISK 501 3380 375 002 XASRES MW READ WRITE MULTIPLE 


806 Installation and Service 


USER DIRECT (3380) 


MDISK 595 3380 377 012 XASRES MW READ WRITE MULTIPLE 


MDISK 190 3380 234 072 XASRES MW ALL 
MDISK 19E 3380 659 044 XASRES MW ALL 
MDISK 19D 3380 496 029 XASRES MW ALL 
MDISK 596 3380 174 020 XASRES MW ALL 
MDISK 59E 3380 525 010 XASRES MW ALL 

* 

* MDISK STATEMENTS FOR INSTALL & SERVICE OF RSCS & PASS-THROUGH 
MDISK 36E 3380 537 002 XASRES RR RPVM WPVM MPVM 
LINK RSCS 191 499 MW 

* 

USER CMSBATCH NOLOG 1M 2M G 
ACCOUNT 3 SYSTEM 
OPTION ACCT 
IPL CMS PARM AUTOCR 
CONSOLE 009 3215 
SPOOL O0C 2540 READER * 

( SPOOL OOD 2540 PUNCH A 


SPOOL BOE 1403 A 
LINK MAINT 190 190 RR 
MDISK 195 3380 494 002 XASRES MR RBATCH WBATCH MBATCH 
* 
USER GCS NOLOG 16M 16M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT GCS RECVM 
IPL GCS 
NAMESAVE GCS 
— CONSOLE 009 3215 
( : SPOOL OOC 2540 READER * 
Wg? SPOOL OOD 2540 PUNCH A 
SPOOL OOF 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19D 19D RR 
LINK MAINT 595 595 
LINK MAINT 59E 59E 
MDISK 191 3380 463 004 XASRES MR RGCS WGCS MGCS 
* 
USER SYSMAINT NOLOG §§ 3M 32M ABCDEFG 
vis AUTOLOG AUTOLOG1 OP1 MAINT 
( | ACCOUNT 1 SYSPROG 
IPL CMS 
CONSOLE 009 3215 T 
SPOOL O0C 2540 READER * 
SPOOL OOD 2540 PUNCH A 
SPOOL BOE 1403 A 
LINK MAINT 123 123 MW 
LINK MAINT 191 192 RR 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
* 
USER OPERATOR NOLOG 16M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 2 OPERATOR 
_ CONSOLE 009 3215 T 
a SPOOL O0C 2540 READER * 
J SPOOL OD 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
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LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 191 3380 719 005 XASRES MR 
LINK OP1 191 192 RR 


* 


*OP1 IS AN ALTERNATE OPERATOR USERID 

* 

USER OP1 NOLOG 3M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 3 OPERATOR 
IPL CMS 
CONSOLE 009 3215 
SPOOL OOC 2540 READER * 

SPOOL QOD 2540 PUNCH A 

SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

MDISK 191 3380 724 001 XASRES MR 
LINK OPERATOR 191 192 RR 


This userid is for the IBM CE's use in running 
OLTSEP. 

OLTSEP is automatically IPLed in the virtual machine. 
A minimum machine size of one megabyte is required to 
run OLTSEP. 

The privilege class of F allows the CE to specify 
intensive recording mode. 

The console address of O1F is required by OLTSEP. 

The unit record addresses are those required by 
OLTSEP. 

The 5FF minidisk is the CE's OLTSEP pack. 


+ + * + + FF FH HF HF HF HF HK F 


USER OLTSEP NOLOG 3M 8M FG 
AUTOLOG AUTOLOG1 OP1 MAINT 

ACCOUNT OLTSEP IBMCE 

IPL 5FF 

CONSOLE O1F 3215 

SPOOL OOC 2540 READER A 

SPOOL 00D 2540 PUNCH A 

SPOOL OOE 1403 A 

MDISK 5FF 3380 000 885 CEPACK MR 


** EREP ** 


This userid is for the IBM CE's use in running 
CPEREP. 

CMS is automatically IPLed in the virtual machine. 
The 190 minidisk is the CMS system disk. 

The 191 minidisk may be used to save often-used EREP 
control statements and procedures (EXECs). 

THE 190 MINIDISK HAS THE CMS TXTLIBS NECESSARY TO RUN 
EREP. 


+ + * FF F F HF HF F 


USER EREP NOLOG 3M 8M BFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT EREP IBMCE 
IPL CMS 
CONSOLE O1F 3215 
SPOOL O0C 2540 READER A 
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SPOOL OOD 2540 PUNCH B 
SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 201 201 RR 
MDISK 191 3380 745 002 XASRES WR READ WRITE MULTIPLE 
* 
USER OPERATNS NOLOG 3M 8M BCEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 1 OPERATNS 
IPL CMS 
CONSOLE 009 3215 
SPOOL QOC 2540 READER D 
SPOOL QOD 2540 PUNCH A 
SPOOL QOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 191 3380 725 017 XASRES MR RDVF WDOVF MDVF 


| * 


USER IPCS NOLOG 3M 8M BCEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 8 CE-ROOM 
IPL CMS 

CONSOLE 009 3215 
SPOOL OOC 2540 READER * 
SPOOL OOD 2540 PUNCH A 
SPOOL QOE 1403 A 

( LINK MAINT 190 190 RR 


LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
LINK OPERATNS 193 192 RR 
* 
USER AUTOLOG1 NOLOG 3M 8M ABCDEG 
AUTOLOG OP1 MAINT 
ACCOUNT 9 SYSTEM 
IPL CMS 
CONSOLE 009 3215 
| SPOOL O0C 2540 READER * 

( SPOOL OOD 2540 PUNCH A 
7 SPOOL O0E 1403 A 
LINK MAINT 190 190 RR 
MDISK 191 3380 742 001 XASRES MR RAUTOLOG WAUTOLOG MAUTOLOG 

* 

USER DISKACNT NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 10 ACCNTNG 

IPL CMS 
CONSOLE 009 3215 
SPOOL 00C 2540 READER * 
SPOOL 00D 2540 PUNCH A 
SPOOL Q0E 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 191 3380 743 001 XASRES MR READ WRITE MULTIPLE 

* 

USER IBMPSR NOLOG 3M 8M BG 
ACCOUNT 10 ACCNTNG 

IPL CMS 
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CONSOLE 009 3215 

SPOOL OOC 2540 READER * 

SPOOL OQ@D 2540 PUNCH A 

SPOOL QOE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

MDISK 191 3380 744 001 XASRES WR 

* 

USER IVPM2 NOLOG 3M 4M G 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT ACT5 IVPM2 
CONSOLE 009 3215 
SPOOL OOC 2540 READER A 
SPOOL OOD 2540 PUNCH A 

SPOOL OOE 1403 A 
LINK MAINT 194 194 RR 
LINK MAINT 190 190 RR 7 
LINK MAINT 19E 19E RR — 


ITALY BMATAT 10NN 10N AN 
LLWN PFUALINNE Lav Lov WAIN 


* 


USER VMUTIL NOLOG 3M 8M BDEG 

AUTOLOG AUTOLOG1 OP1 MAINT 

ACCOUNT 11 SYSTEM 

IPL CMS 

CONSOLE 009 3215 

SPOOL O@C 2540 READER * 

SPOOL O@D 2540 PUNCH A 

SPOOL OOE 1403 A va 
LINK MAINT 190 190 RR a 
LINK MAINT 19E 19E RR ae? 
LINK MAINT 19D 19D RR 
* 
USER SYSDUMP1 NOLOG 3M 8M BG 

AUTOLOG AUTOLOG1 OP1 MAINT 

ACCOUNT 12 SYSTEM 

IPL CMS 

CONSOLE 009 3215 

SPOOL OOC 2540 READER * _ 
SPOOL OD 2540 PUNCH A a » 
SPOOL OOE 1403 A aed 
LINK MAINT 190 190 RR 

LINK MAINT 19E 19E£ RR 

LINK MAINT 19D 19D RR 

MDISK 123 3380 000 885 XASRES RR 

MDISK 124 3380 000 885 XAPOO1 RR 

MDISK 125 3380 ©00 885 XASERV RR 


* 


* 


USER RSCS NOLOG 3M 8M BEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 13 SYSTEM 

NOPDATA 

IPL 191 
CONSOLE 009 3215 
SPOOL O0C 2540 READER * 
SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
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USER DIRECT (3380) 


LINK MAINT 19D 19D RR 
MDISK 191 3380 535 002 XASRES MR RRSCS WRSCS MRSCS 

ae * 

USER PVM NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 14 SYSTEM 

TPL CMS 

CONSOLE 009 3215 

SPOOL OOC 2540 READER * 
SPOOL O0@D 2540 PUNCH A 
SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
LINK MAINT 36E 191 MR 


* 


* 


HHKKEKKEKEKEKEKKEKEKKEKEKRKREREKREEREKREKREKREKREREERRREKERRERRKERERRKRKKKRKKKKE 


: OTHER OPERATING SYSTEM USERIDS * 


KKIKEKEKKERKEEKEREEKEKREKKEKREKEKEREKEREKERKREKEEKREKEKKRERERKEKREKKEKE 
* 
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XAMAINT Directory Entry (3380) 


Sample XAMAINT Directory Entry for 3380 


If you are using the procedure in Chapter 4, “Installing VM/XA Smee Product Release 2 Using : an Existing 
VM/SP or VM/SP HPO System” on page 219 to install your system, add the following entry to your 
directory: 


* 


USER XAMAINT NOLOG 16M 16M ABCDEFG 
OPTION ECMODE DIAG98 

ACCOUNT 1 SYSPROG 

IPL 190 
*NAMESAVE: GCS 
*NAMESAVE VTAM 
*NAMESAVE HELP 
*NAMESAVE INSTHELP 

CONSOLE 009 3215 T 

SPOOL OOC 2540 READER * 

SPOOL OOD 2540 PUNCH A 

SPOOL OOE 1403 A 

MDISK 123 3380 000 885 XASRES MW | 
MDISK 124 3380 000 885 XAPOQO1 RR Mg 
MDISK 125 3380 000 885 XASERV RR 


MDISK 191 3380 703 016 XASRES MW 
MDISK 193 3380 128 046 XASRES MW 
MDISK 194 3380 747 056 XASRES MW 
MDISK 201 3380 043 022 XASERV MW RMAINT WMAINT MMAINT 


MDISK 192 3380 065 015 XASERV MW READ WRITE MULTIPLE 
MDISK 392 3380 80 @15 XASERV MW READ WRITE MULTIPLE fo™ 
MDISK 492 3380 095 010 XASERV MW READ WRITE MULTIPLE aw 
MDISK 692 3380 105 @1@ XASERV MW READ WRITE MULTIPLE 
MDISK 594 3380 115 @60 XASERV MW READ WRITE MULTIPLE 
MDISK 593 3380 175 040 XASERV MW READ WRITE MULTIPLE 


MDISK 295 3380 559 030 XASRES MW READ WRITE MULTIPLE 
MDISK 395 3380 589 020 XASRES MW READ WRITE MULTIPLE 
MDISK 495 3380 265 005 XASERV MW READ WRITE MULTIPLE 
MDISK 592 3380 270 010 XASERV MW READ WRITE MULTIPLE 


MDISK 892 3380 280 005 XASERV MW READ WRITE MULTIPLE rosy 
MDISK 491 3380 285 010 XASERV MW READ WRITE MULTIPLE Ry 
MDISK 791 3380 295 010 XASERV MW READ WRITE MULTIPLE ae 


MDISK 89E 3380 305 010 XASERV MW READ WRITE MULTIPLE 
MDISK 896 3380 315 010 XASERV MW READ WRITE MULTIPLE 
MDISK 895 3380 325 010 XASERV MW READ WRITE MULTIPLE 


MDISK 490 3380 362 072 XASERV MW 
MDISK 423 3380 434 010 XASERV MW 
MDISK 293 3380 444 Q60 XASERV MW RCMSAUX WCMSAUX MCMSAUX 
MDISK 294 3380 504 080 XASERV MW RCPAUX WCPAUX MCPAUX 
MDISK 393 3380 389 056 XASRES WR 
MDISK 394 3380 584 130 XASERV WR 
MDISK 19C 3380 763 029 XASERV WR 
MDISK 49C 3380 792 029 XASERV WR 


MDISK 291 3380 803 060 XASRES MW | 

MDISK 391 3380 215 040 XASERV MW —_ 
MDISK 591 3380 821 060 XASERV MW READ WRITE MULTIPLE iy 
MDISK 691 3380 306 040 XASRES MW READ WRITE MULTIPLE - 
MDISK 49D 3380 346 029 XASRES MW READ WRITE MULTIPLE 
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XAMAINT Directory Entry (3380) 


MDISK 501 3380 375 002 XASRES MW READ WRITE MULTIPLE 
MDISK 595 3380 377 012 XASRES MW READ WRITE MULTIPLE 


C MDISK 190 3380 234 072 XASRES MW ALL 
| MDISK 19E 3380 659 044 XASRES MW ALL 
MDISK 19D 3380 496 029 XASRES MW ALL 
MDISK 596 3380 174 020 XASRES MW ALL 
MDISK 59E 3380 525 010 XASRES MW ALL 
* 
* MDISK STATEMENTS FOR INSTALL & SERVICE OF RSCS & PASS-THROUGH 
MDISK 36E 3380 537 002 XASRES RR RPVM WPVM MPVM 
LINK RSCS 191 499 MW 
LINK MAINT 190 390 RR 


* 


haus 
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XASRES Volume Allocation (3380) 


System Residence DASD Allocation for 3380 


Figure 58 shows the allocation for the system residence device for the 3380 VM/XA SP starter system. The 
allocation and minidisk maps for the 3380-E4 (“System Residence DASD Allocation for 3380-E4” on 

page 828 and “Minidisk Maps for 3380-E4 System Residence Device” on page 829) and 3380-K (“System 
Residence DASD Allocation for 3380-K” on page 843 and “Minidisk Maps for 3380-K System Residence 
Device” on page 844) follow the corresponding sample directories (“Sample Directory for 3380-E4” on 
page 817 and “Sample Directory for 3380-K” on page 832 respectively). 


TYPE CYL CYL 
PERM 000-000 
DRCT 001-002 
PERM 003-013 
PAGE 014-037 
SPOL 038-074 
PERM 075-197 
TDSK 198-216 | Bie 
PERM 217-884 _ 


Figure 58. System Residence DASD Allocation for 3380 


\ 
Se _? / 
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Minidisk Maps (3380) 


Minidisk Maps for 3380 System Residence Device 


( a Figure 59 shows the minidisk maps of the system residence device for the 3380. To map your own system 
| residence device for comparison, issue DISKMAP fn DIRECT, where /m is the name of your directory. 


VOLUME USERID CUU DEVTYPE START END SIZE 
CEPACK OLTSEP 5FF 3380 0000 0884 0885 
VOLUME USERID CUU DEVTYPE START END SIZE 
XAPQO1 $ALLOC$ C01 3380 0000 0000 0001 
MAINT 124 3380 0000 0884 0885 **OVERLAP** 


SYSDUMP1 124 3380 0000 0884 0885 **OVERLAP** 


VOLUME USERID CUU DEVTYPE START END SIZE 
XASERV $ALLOC$ BO1 3380 0000 0000 0001 
1 42 42 GAP 
MAINT 201 3380 0043 0064 0022 
MAINT 192 3380 0065 0079 0015 
MAINT 392 3380 0080 0094 0015 
MAINT 492 3380 0095 0104 0010 
PA, MAINT 692 3380 0105 0114 0010 
( ! MAINT 594 3380 0115 0174 0060 
MAINT 593 3380 0175 0214 0040 
MAINT 391 3380 0215 0254 0040 
255 264 10 GAP 
MAINT 495 3380 0265 0269 0005 
MAINT 592 3380 0270 0279 0010 
MAINT 892 3380 0280 0284 0005 
MAINT 491 3380 0285 0294 0010 
MAINT 791 3380 0295 0304 0010 
= MAINT 80E 3380 0305 0314 0010 
( | MAINT 896 3380 0315 0324 0010 
_ MAINT 895 3380 0325 0334 0010 
335 361 27. ~—«GAP 
MAINT 499 3380 0362 0433 0072 
MAINT 423 3380 0434 0443 0010 
MAINT 293 3380 0444 0503 0060 
MAINT 294 3380 0504 0583 0080 
MAINT 394 3380 0584 0713 0130 
714 762 49 GAP 


Figure 59 (Part 1 of 3). Minidisk Maps of the System Residence Device for 3380 
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Minidisk Maps (3380) 


MAINT | | 0029 


MAINT 9029 ee 
MAINT 9060 | aad 
MAINT 0885 **OVERLAP** 


SYSDUMP1 0885 **OVERLAP** 


VOLUME USERID CUU DEVTYPE START END SIZE 
XASRES  $ALLOC$ A01 3380 0000 0000 0001 
$DIRECT$ A04 3380 0001 0002 §=§=—_ 9002 
$CP-NUC$ AQ9 3380 0003 0012 0010 
$SYSCKP$  A06 3380 0013 0014 0002 
$SYSWRM$ A07 3380 0015 0016 0002 


$PAGE$ AQ3 3380 0017 0040 0024 
$SPOOL$ BO1 3380 0041 0127 0087 
MAINT 193 3380 0128 0173 0046 
MAINT 596 3380 0174 0193 0020 a 
194 233 46 GAP \ 
MAINT 190 3380 0234 0305 0072 
MAINT 691 3380 0306 0345 0040 
MAINT 49D 3380 0346 0374 0029 
MAINT 501 3380 0375 0376 0002 
MAINT 595 3380 0377 0388 0012 
MAINT 393 3380 0389 0444 0056 
445 462 18 GAP 
GCS 191 3380 0463 0466 0004 
467 492 26 ~=GAP a 
LGLOPR 191 3380 0493 0493 0001 =. 
CMSBATCH = 195 3380 0494 0495 0002 ad 
MAINT 19D 3380 0496 0524 0029 
MAINT 59E 3380 0525 0534 0010 
RSCS 191 3380 0535 0536 0002 
MAINT 36E 3380 0537 0538 0002 
$T-DISK$ BO 3380 0539 0558 0020 
MAINT 295 3380 0559 0588 0030 
MAINT 395 3380 0589 0608 0020 
609 658 50 GAP Par 
( 
Figure 59 (Part 2 of 3). Minidisk Maps of the System Residence Device for 3380 Ne 
MAINT 19E 3380 0659 0702 0044 
MAINT 191 3380 0703 0718 0016 
OPERATOR 191 3380 0719 0723 0005 
OP1 191 3380 0724 0724 0001 
OPERATNS 191 3380 0725 0741 0017 
AUTOLOG1 191 3380 0742 0742 0001 
DISKACNT 191 3380 0743 0743 0001 
IBMPSR 191 3380 0744 0744 0001 
EREP 191 3380 0745 0746 0002 
MAINT 194 3380 0747 0802 0056 
MAINT 291 3380 0803 0862 0060 
MAINT 123 3380 0000 0884 0885 **OVERLAP** 


SYSDUMP1 123 3380 0000 0884 0885 **OVERLAP** 


Figure 59 (Part 3 of 3). Minidisk Maps of the System Residence Device for 3380 
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USER DIRECT (3380-E4) 


Sample Directory for 3380-E4 


This is only a sample file. You need to tailor it to your installation before it can be used. 


KREEKERERERERKRERKEEKREREREREKRREKRERERRERKRERRRERERRREKRRKRERREKERERKKEE 


an Virtual Machine / System Product 5664-308 RE 
rae Contains restricted materials of IBM ane 
li Copyright (c) I BM Corporation 1988 eae 
eae Licensed Materials - Property of I BM fee 


eee Refer to Copyright Instructions: Form G120-2083 aa 


KKEKKEEKKEEKREREREKREKEKREREREERERREERREKREKREKRRRREKREREREKRRERREERERER 


KBRREKEKEKKKREKRAKREKEKREREEKEKREREERERERKREREERKEKREKRRREREREREKREKREREEKE 


3380-E4 SYSTEM VM/XA SYSTEM PRODUCT DIRECTORY 

THE ADDRESSES 123, 124, AND 125 ARE VIRTUAL ADDRESSES. 

THE ADDRESS 123 IS CRITICAL SINCE IT IS USED IN HCPSYS AND 
THE DIRECTORY. IF YOU WANT TO CHANGE IT, REMEMBER IT MUST 
BE CHANGED IN HCPSYS, THE 'DIRECTORY' STATEMENT BELOW, 

AND IN THE 'MDISK' STATEMENTS FOR THE USERID ‘MAINT’. 
NOTE: REMEMBER THESE ARE ONLY VIRTUAL ADDRESSES NOT REAL 
ADDRESSES, SOQ THERE IS NO NEED TO CHANGE THEM TO MATCH 
YOUR HARDWARE ADDRESSES. 


THIS DIRECTORY MUST BE MODIFIED IF MDISK PASSWORDS ARE TQ 
BE SPECIFIED. WITHOUT MDISK PASSWORDS, MDISKS CANNOT BE 

SHARED USING THE 'CP LINK' COMMAND. A SAMPLE USER ENTRY 

FOLLOWS: (NOTE ONLY THE MDISK STATEMENT) | 


USER ANYONE SOMEPASS 3M 8M FG 
AUTOLOG AUTOLOG1 OP1 MAINT 
IPL 190 
CONSOLE O1F 3215 
SPOOL O0C 2540 READER A 
SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 
*=e===>  MDISK 999 33XX XXX YYY ZZZZZZ MR RPASS WPASS MPASS 


ee F&F SF FE FE FE HF FF FE HF HF HE HE FH FH HK HF KF HH HF HF HF 


WHERE: RPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 
READ ONLY MODE. 
WPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 
WRITE MODE. 
MPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 
MULTI-WRITE MODE. 


NOTE: EACH PASSWORD MAY BE 1-8 CHARACTERS IN LENGTH. 


> 
oO 
=) 
| 
e 
= 
— 
~ 
ie] 
~“ 
_N 
~ 
a] 
FF FF F FF HF FH FF F HF HF HF HF HF FF KF HF HF HF HF HF HF HF HF FF HF KF 


FF FF F HF F HF 


KKKEKEKKREREKERERERE REE REE RREREREREREEREREREEKRRRERRRKEKRERREKREKRRKRKEKE 


Following is a sample user entry and a brief description 
of each entry. A more detailed description may be found 
by referencing the VM/XA System Product Planning and 
Administration manual. | 


USER CMS1 abc123 3M 32M G 
- Userid is CMS1 
- Logon password is abc123 
- .At logon time, virtual storage will equal 3M 
- Maximum storage that may be defined equals 32M 
- Privilege class is G 


+ + F F Fe FF F F HF F 
4 + + FF + FH F F HF OF YF 
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USER DIRECT (3380-E4) 


AUTOLOG AUTOLOG1 OP1 MAINT 7 
- Allows user CMS1 to be autolog'd by AUTOLOG1, 
OP1, and MAINT 


ACCOUNT ACT4 CMSTST 
- Time used by CMS1 will be charged to account ACT4 
- Printed output will be sent to distribution CMSTST 


IPL CMS 
- Will cause automatic IPL of named save system of 
CMS 


CONSOLE 009 3215 
- Defines virtual machines console as a 3215 at a 
virtual address of 009 


SPOOL OO0C 2540 READER A 
SPOOL 00D 2540 PUNCH A 
SPOOL OOE 1403 A 
- Defines virtual unit record devices of reader, 
punch, and printer with a spooling class of ‘A’ 


LINK MAINT 190 190 RR 
- Allows read access to minidisk 190 of user 'MAINT' 


LINK MAINT 19E 19E RR 
- Allows read access to minidisk 19E of user ‘MAINT' 


LINK MAINT 19D 19D RR 
- Allows read access to minidisk 19d of user 'MAINT' 


MDISK 999 3350 236 022 CPPACK WR RPASS WPASS 

- Defines minidisk with a virtual address of 999 

- Specifies that the minidisk resides on a real 3350 

- Minidisk starts at cylinder 236 

- Mdisk is 22 cylinders in size (starting at cyl 236 

- The real volume serial number is 'CPPACK' 

- Mdisk is to be accessed in write mode if no other 
user has write access. Alternate access read-only 

- RPASS is the required password for another user to 
link to this minidisk in read mode 

- WPASS is the required password for another user to 


link to this minidisk in write mode 
KKK HK KKKRKKRKERKERRR RRR KR RRR RRR RRR RRR RRR KR RRR: 


 * € FF FF FF FF FH HE HF HF HF HF HK HF HF HF HF HF KF HF KF HF KF HF HF HF HF HF HF HF HF HF FF F H 
+ * FF FF HF FF HF HF HF HF HK HF HK HF HH HF HF HF HF HF HF HF HF HF HF HF % HF HF HF HF HF HF HF HF F HK HF 


* 

* 

* 

DIRECTORY 123 3380 XASRES 

‘ 

EIR IR IR KI RII RIKI III RII IAI A BI a a a a a a a bs a a a I 
* SYSTEM RESERVED AREAS NOT FOR MINIDISKS * 
KAKI KKK RK KERR REE RK REE KERR REE RRR RRR ERE KERR ERE RRR RIE R 
* 


USER $ALLOC$ NOLOG 

MDISK AQ1 3380 000 001 XASRES R 
MDISK BOQ1 3380 000 001 XASERV R 
MDISK COQ1 3380 000 001 XAPOO1 R 


* 


USER $DIRECT$ NOLOG 
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yo 


> 


/ 
; 


‘ 


USER DIRECT (3380-E4) 


MDISK AQ4 3380 001 002 XASRES R 
* 

USER $CP-NUC$ NOLOG 

MDISK AQ9 3380 003 010 XASRES R 
* 

USER $SYSCKP$ NOLOG 

MDISK AQ6 3380 613 002 XASRES R 
* 

USER $SYSWRM$ NOLOG 

MDISK AQ7 3380 615 002 XASRES R 
* 

USER $PAGE$  NOLOG 

MDISK AQ3 3380 017 024 XASRES R 
* 

USER $SPOOL$ NOLOG 

MDISK BO1 3380 041 087 XASRES R 
* 

USER $T-DISK$ NOLOG 

MDISK BO1 3380 539 020 XASRES R 


* 
KHKAEKKEKKEKKEKEKERKEKKEKREKREREKRKREEKREKKEREKKREKEREKKREKKEKRKKKRAEKRRRKRKKK 
* CMS USERIDS * 
KEKKREREKEERKEREREKEEREREERRERRKREKRRREKRREKEKRREREKEREKREKRRREEKREREEEE 
* 


USER CMS1 NOLOG 3M 32M G 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT ACT4 CMSTST 

IPL CMS 

CONSOLE 009 3215 

SPOOL O0C 2540 READER A 
SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 


* 
Je FE IE IIE III HTK TAI II II II TTR TOR IIE III IAI IAI IIIA III IIIS III III IIIS IERIE 
= PROP LOGICAL OPERATOR * 
HK RK KIRK KICK IKI TKR IKI IIK III IIIA III III III III IRI IAAI IIIA 
* 


USER LGLOPR NOLOG 512K 16M ABCDEG 
ACCOUNT ACT1 PROP 
IPL CMS 

CONSOLE 009 3215 

SPOOL OOC 2540 READER A 

SPOOL OOD 2540 PUNCH A 

SPOOL QOE 1403 A 

MDISK 191 3380 493 001 XASRES WR 
LINK MAINT 194 194 RR 

LINK MAINT 190 190 RR 

LINK OPERATOR 191 291 RR 


* 
KRREKEEKEKREKRKREREKRERREKEKRKEREKREREREREREEKREERERERERKERKRERERERRERREKER 
* SYSTEM RELATED USERIDS * 
KEKRKEREKREREKKEKREKEKEERKEEREEERKREKEKREKRRERERERERRERERREEEKEERKEKKEK 
* 


USER MAINT NOLOG 16M 32M ABCDEFG 
AUTOLOG AUTOLOG] OP1 MAINT 
ACCOUNT 1 SYSPROG 
IPL 190 
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USER DIRECT (3380-E4) 


NAMESAVE GCS 
NAMESAVE VTAM 
NAMESAVE HELP 
NAMESAVE INSTHELP 
CONSOLE 009 3215 T 

Q0C 2540 READER * 


SPOOL 
SPOOL 
SPOOL 
MDISK 
MDISK 
MDISK 


MDISK 
MDISK 
MDISK 
MDISK 


MDISK 
MDISK 
MDISK 
MDISK 


MDISK 
MDISK 


MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 


MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 


MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 
MDISK 


MDISK 
MDISK 
MDISK 


* 


* MDISK STATEMENTS FOR INSTALL & SERVICE OF RSCS & PASS-THROUGH 


820 


00D 
OOE 
123 
124 
125 


191 
193 
194 
201 


192 
392 
492 
692 


593 
594 


295 
395 
495 
592 
892 
491 
791 
89E 
896 
895 


490 
423 
293 
294 
393 
394 
19C 
49C 
596 
59E 


391 
591 
691 
49D 
501 
595 
291 


190 
19E 
19D 


2540 
1403 
3380 
3380 
3380 


3380 
3380 
3380 
3380 


3380 


3380 
3380 
3380 


3380 
3380 


3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 


3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 


3380 
3380 
3380 
3380 
3380 
3380 
3380 


3380 
3380 
3380 


PUNCH A 
A 


0000 1770 XASRES MW 


0000 1770 XAPQO1 RR 


0000 1770 XASERV RR 


0703 016 
0128 046 


0362 056 


0789 022 


0811 015 
0826 015 
0841 010 
0851 010 


0861 040 
0901 060 


0961 030 
0991 020 
1011 005 
1016 010 
1026 005 
1031 010 
1041 010 
1051 010 
1061 010 
1071 010 


1108 072 
1180 010 
1190 060 
1250 080 
0306 056 
1330 130 
1509 029 
1538 029 
1567 020 
1587 010 


0559 040 
1597 060 
1657 040 
1697 029 
1726 002 
1728 012 
Q599 060 


0234 072 
0174 044 
0659 029 


XASRES 
XASRES 
XASRES 
XASRES 


XASRES 
XASRES 
XASRES 
XASRES 


XASRES 
XASRES 


XASRES 
XASRES 
XASRES 
XASRES 
XASRES 
XASRES 
XASRES 
XASRES 
XASRES 
XASRES 


XASRES 
XASRES 
XASRES 
XASRES 
XASRES 
XASRES 
XASRES 
XASRES 
XASRES 
XASRES 


XASRES 
XASRES 
XASRES 
XASRES 
XASRES 
XASRES 
XASRES 


XASRES 
XASRES 
XASRES 
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MW 
MW 


RMAINT 


READ WRITE 
READ WRITE 
READ WRITE 
READ WRITE 


READ WRITE 
READ WRITE 


READ WRITE 
READ WRITE 
READ WRITE 
READ WRITE 
READ WRITE 
READ WRITE 
READ WRITE 
READ WRITE 
READ WRITE 
READ WRITE 


RCMSAUX WCMSAUX MCMSAUX 
WCPAUX 


RCPAUX 


WMAINT 


MULTIPLE 
MULTIPLE 
MULTIPLE 
MULTIPLE 


MULTIPLE 
MULTIPLE 


MULTIPLE 
MULTIPLE 
MULTIPLE 
MULTIPLE 
MULTIPLE 
MULTIPLE 
MULTIPLE 
MULTIPLE 
MULTIPLE 
MULTIPLE 


READ WRITE MULTIPLE 
READ WRITE MULTIPLE 
READ WRITE MULTIPLE 


READ WRITE MULTIPLE 
READ WRITE MULTIPLE 


ALL 
ALL 
ALL 


MMAINT 


MCPAUX 


Sa” 


USER DIRECT (3380-E4) 


MDISK 36E 3380 0537 002 XASRES RR RPVM WPVM =—s MPVM 
LINK RSCS 191 499 MW 
* 
USER CMSBATCH NOLOG 1M 2M G 

ACCOUNT 3 SYSTEM 

OPTION ACCT 

IPL CMS PARM AUTOCR 

CONSOLE 009 3215 

SPOOL @@C 2540 READER * 

SPOOL @@D 2540 PUNCH A 

SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 

MDISK 195 3380 494 002 XASRES MR RBATCH WBATCH MBATCH 

* 

USER GCS NOLOG 16M 16M ABCDEFG 
AUTOLOG AUTOLOG1 OPI MAINT 
ACCOUNT GCS RECVM 
IPL GCS 
-_ NAMESAVE GCS 

( | CONSOLE 009 3215 

SPOOL GOC 2540 READER * 

SPOOL 60D 2540 PUNCH A 

SPOOL O0E 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19D 19D RR 

LINK MAINT 595 595 

LINK MAINT 59E 59E 

MDISK 191 3380 463 004 XASRES MR RGCS WGCS MGCS 

( | USER SYSMAINT NOLOG © 3M 32M ABCDEFG 

- AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 1 SYSPROG 

IPL CMS 

CONSOLE 009 3215 T 
SPOOL @@C 2540 READER * 
SPOOL 66D 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 123 123 MW 

| LINK MAINT 191 192 RR 

( LINK MAINT 190 190 RR 
cn LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

* 

USER OPERATOR NOLOG 16M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 2 OPERATOR 
CONSOLE 069 3215 T 
SPOOL @@C 2540 READER * 

SPOOL @@D 2540 PUNCH A 
SPOOL QGE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 

MDISK 191 3380 719 005 XASRES MR 
LINK OP1 191 192 RR : 


* 


*OP1 IS AN ALTERNATE OPERATOR USERID 
* 

USER OP1 NOLOG 3M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
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USER DIRECT (3380-E4) 


+ + FF + + FF + HF HF HF F HF F 


U 


+ + + + $F HF HF HH FH HF 


U 


* 


U 


ACCOUNT 3 OPERATOR 

IPL CMS 

CONSOLE 009 3215 

SPOOL O0C 2540 READER * 
SPOOL QOD 2540 PUNCH A 
SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 191 3380 724 001 XASRES MR 
LINK OPERATOR 191 192 RR 


This userid is for the IBM CE's use in running 
OLTSEP. 

OLTSEP is automatically IPLed in the virtual machine. 
A minimum machine size of one megabyte is required to 
run OLTSEP. 

The privilege class of F allows the CE to specify 
intensive recording mode. 

The console address of O1F is required hy OLTSEP. 

The unit record addresses are those required by 
OLTSEP. 

The 5FF minidisk is the CE's OLTSEP pack. 


SER OLTSEP NOLOG 3M 8M FG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT OLTSEP IBMCE 
IPL 5FF 
CONSOLE O1F 3215 
SPOOL OC 2540 READER A 
SPOOL OOD 2540 PUNCH A 
SPOOL QOE 1403 A 
MDISK 5FF 3380 000 1770 CEPACK MR 


** EREP ** 


This userid is for the IBM CE's use in running 
CPEREP. 

CMS is automatically IPLed in the virtual machine. 
The 190 minidisk is the CMS system disk. 

The 191 minidisk may be used to save often-used EREP 
control statements and procedures (EXECs). 

THE 190 MINIDISK HAS THE CMS TXTLIBS NECESSARY TO RUN 
EREP. 


SER EREP NOLOG 3M 8M BFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT EREP IBMCE 
IPL CMS 

CONSOLE O1F 3215 

SPOOL OOC 2540 READER A 
SPOOL 00D 2540 PUNCH B 
SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 201 201 RR 
MDISK 191 3380 745 002 XASRES WR READ WRITE MULTIPLE 


SER OPERATNS NOLOG 3M 8M BCEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 1 OPERATNS 
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USER DIRECT (3380-E4) 


IPL CMS 

CONSOLE 009 3215 

SPOOL OOC 2540 READER D 

SPOOL OOD 2540 PUNCH A 

SPOOL QOE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

MDISK 191 3380 725 017 XASRES MR RDVF WDVF MDVF 


* 


* 


USER IPCS NOLOG 3M 8M BCEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 8 CE-ROOM 
IPL CMS 
CONSOLE 009 3215 
SPOOL O0C 2540 READER * 
SPOOL 00D 2540 PUNCH A 
roe SPOOL OOF 1403 A 
( | LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
LINK OPERATNS 193 192 RR 
* 
USER AUTOLOG1 NOLOG 3M 8M ABCDEG 
AUTOLOG OP1 MAINT 
ACCOUNT 9 SYSTEM 
IPL CMS 
= CONSOLE 009 3215 
( ‘ SPOOL @OC 2540 READER * 
=. SPOOL QOD 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
MDISK 191 3380 742 001 XASRES MR RAUTOLOG WAUTOLOG MAUTOLOG 
* 
USER DISKACNT NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 10 ACCNTNG 
IPL CMS 
mo CONSOLE 009 3215 
( SPOOL OOC 2540 READER * 
SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 191 3380 743 001 XASRES MR READ WRITE MULTIPLE 
* 
USER IBMPSR NOLOG 3M 8M BG 
ACCOUNT 10 ACCNTNG 
IPL CMS 
CONSOLE 009 3215 
SPOOL O0C 2540 READER * 
SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E£ 19E RR 
LINK MAINT 19D 19D RR 
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USER DIRECT (3380-E4) 


MDISK 191 3380 744 001 XASRES WR 

* 

USER IVPM2 NOLOG 3M 4M G 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT ACT5 IVPM2 
CONSOLE 009 3215 
SPOOL O0C 2540 READER A 
SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 194 194 RR 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 

* 

USER VMUTIL NOLOG 3M 8M BDEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 11 SYSTEM 

IPL CMS 
CONSOLE 009 3215 

SPOOL OO0C 2540 READER * 

SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 

* 

USER SYSDUMP1 NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 12 SYSTEM 

IPL CMS 

CONSOLE 009 3215 
SPOOL O0C 2540 READER * 

SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 123 3380 000 1770 XASRES RR 
MDISK 124 3380 000 1770 XAPQO1 RR 
MDISK 125 3380 000 1770 XASERV RR 


* 


* 


USER RSCS NOLOG 3M 8M BEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 13 SYSTEM 

NOPDATA 
IPL 191 
CONSOLE 009 3215 
SPOOL QOC 2540 READER * 
SPOOL 00D 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 191 3380 535 002 XASRES MR RRSCS 

* 

USER PVM NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 14 SYSTEM 

IPL CMS 
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WRSCS 


MRSCS 


USER DIRECT (3380-E4) 


CONSOLE 009 3215 
SPOOL Q0C 2540 READER * 
_ SPOOL @6D 2540 PUNCH A 
( : SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
LINK MAINT 36E 191 MR 


* 
* 
FI IIR IR RR RRR IR IR III IAI III RII II IIASA RII IASI II IIIA AIA AIA 
* OTHER OPERATING SYSTEM USERIDS i 
KK KK KIKI III IK III IAAI ASAI IIASA ISS SSSI III ANANSI NSN SII AIS NSS 
* 
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XAMAINT Directory Entry (3380-E4) 


Sample XAMAINT Directory Entry for 3380-E4 


If you are using the procedure in Chapter 4, “Installing VM/XA System Product Release 2 Using an Existing 
VM/SP or VM/SP HPO System” on page 219 to install your system, add the following entry to your 
directory: 


* 


USER XAMAINT NOLOG 16M 16M ABCDEFG 
OPTION ECMODE DIAG98 
ACCOUNT 1 SYSPROG 
IPL 190 

*NAMESAVE GCS 

*NAMESAVE VTAM 

*NAMESAVE HELP 

*NAMESAVE INSTHELP 
CONSOLE 009 3215 T 
SPOOL OOC 2540 READER * 
SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 


MDISK 123 3380 000 1770 XASRES MW —_ 
MDISK 124 2380 9008 1779 XAPQQ1 RR 


wer www 


MDISK 125 3380 0000 1770 XASERV RR 


MDISK 191 3380 0703 016 XASRES MW 
MDISK 193 3380 0128 046 XASRES MW 
MDISK 194 3380 0362 056 XASRES MW 
MDISK 201 3380 0789 022 XASRES MW RMAINT WMAINT MMAINT 


MDISK 192 3380 0811 015 XASRES MW READ WRITE MULTIPLE 
MDISK 392 3380 0826 015 XASRES MW READ WRITE MULTIPLE 
MDISK 492 3380 0841 010 XASRES MW READ WRITE MULTIPLE 
MDISK 692 3380 0851 010 XASRES MW READ WRITE MULTIPLE 


co 


MDISK 593 3380 0861 040 XASRES MW READ WRITE MULTIPLE 
MDISK 594 3380 0901 060 XASRES MW READ WRITE MULTIPLE 


MDISK 295 3380 0961 030 XASRES MW READ WRITE MULTIPLE 
MDISK 395 3380 0991 020 XASRES MW READ WRITE MULTIPLE 
MDISK 495 3380 1011 005 XASRES MW READ WRITE MULTIPLE 
MDISK 592 3380 1016 010 XASRES MW READ WRITE MULTIPLE 
MDISK 892 3380 1026 005 XASRES MW READ WRITE MULTIPLE | : 
MDISK 491 3380 1031 010 XASRES MW READ WRITE MULTIPLE eee 
MDISK 791 3380 1041 010 XASRES MW READ WRITE MULTIPLE © 

MDISK 89E 3380 1051 010 XASRES MW READ WRITE MULTIPLE 

MDISK 896 3380 1061 010 XASRES MW READ WRITE MULTIPLE 

MDISK 895 3380 1071 010 XASRES MW READ WRITE MULTIPLE 


MDISK 490 3380 1108 072 XASRES MW 

MDISK 423 3380 1180 010 XASRES MW 

_ MDISK 293 3380 1190 060 XASRES MW RCMSAUX WCMSAUX MCMSAUX 
MDISK 294 3380 1250 080 XASRES MW RCPAUX WCPAUX MCPAUX 
MDISK 393 3380 0306 056 XASRES WR 

MDISK 394 3380 1330 130 XASRES WR 

MDISK 19C 3380 1509 029 XASRES WR 

MDISK 49C 3380 1538 029 XASRES WR 

MDISK 596 3380 1567 020 XASRES WR 

MDISK 59E 3380 1587 010 XASRES WR 


MDISK 391 3380 0559 040 XASRES MW 
MDISK 591 3380 1597 060 XASRES MW READ WRITE MULTIPLE 
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XAMAINT Directory Entry (3380-E4) 


MDISK 691 3380 1657 040 XASRES MW READ WRITE MULTIPLE 

aan MDISK 49D 3380 1697 029 XASRES MW READ WRITE MULTIPLE 

( | MDISK 501 3380 1726 002 XASRES MW READ WRITE MULTIPLE 

" MDISK 595 3380 1728 012 XASRES MW READ WRITE MULTIPLE 
MDISK 291 3380 0599 060 XASRES MW 


MDISK 190 3380 0234 072 XASRES MW ALL 

MDISK 19E 338Q 0174 044 XASRES MW ALL 

MDISK 19D 3380 0659 029 XASRES MW ALL 
* 
* MDISK STATEMENTS FOR INSTALL & SERVICE OF RSCS & PASS-THROUGH 
MDISK 36E 3380 0537 002 XASRES RR RPVM WPVM MPVM 

LINK RSCS 191 499 MW 

LINK MAINT 190 390 RR 


* 


sn ne 
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XASRES Volume Allocation (3380-E4) 


System Residence DASD Allocation for 3380-E4 


Figure 60 shows the allocation for the system residence device for the 3380-E4 VM/XA SP Starter System. 


TYPE CYL CYL 
PERM 0000-0000 
DRCT 0001-0002 
PERM 0003-0013 


PAGE 0014-0037 
SPOL 0038-0074 
PERM 0075-0197 
TDSK 0198-0216 
PERM 0217-1769 


Figure 60. System Residence DASD Allocation for 3380-E4 
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poi ortin 


Minidisk Maps (3380-E4) 


Minidisk Maps for 3380-E4 System Residence Device 


Figure 61 shows the minidisk maps of the system residence device for the 3380-E4. To map your own system 
residence device for comparison, issue DISKMAP fn DIRECT, where fn is the name of your directory. 


VOLUME USERID CUU DEVTYPE START END SIZE 

CEPACK OLTSEP 5FF 3380 0000 1769 1770 

VOLUME USERID CUU DEVTYPE START END SIZE 

XAPQO1  $ALLOC$ COl 3380 0000 0000 0001 ! 
MAINT 124 3380 0000 1769 1770 **OVERLAP** 


SYSDUMP1 124 3380 0000 1769 1770 **OVERLAP** 


VOLUME USERID CUU = DEVTYPE START END SIZE 
XASERV $ALLOC$ Bol 3380 0000 0000 0001 
MAINT 125 3380 0000 1769 1770 **OVERLAP** 


SYSDUMP1 125 3380 0000 1769 1770 **OVERLAP** 


VOLUME USERID CUU = DEVTYPE = START END SIZE 
XASRES  $ALLOC$ AQ1 3380 0000 0000 0001 
$DIRECT$ A04 3380 0001 0002 0002 
$CP-NUC$ A09 3380 0003 0012 0010 
$SYSCKP$ AQ6 3380 0013 0014 0002 
$SYSWRM$ AQ7 3380 0015 0016 0002 


$PAGE$ AQ3 3380 0017 0040 0024 
$SPOOL$ BO] 3380 0041 0127 0087 
MAINT 193 3380 0128 0173 0046 
MAINT 19E 3380 0174 0217 0044 

218 233 16 GAP 
MAINT 190 3380 0234 0305 0072 
MAINT 393 3380 0306 0361 0056 
MAINT 194 3380 0362 0417 0056 

418 462 45 GAP 
GCS 191 3380 0463 0466 0004 

467 492 26 GAP 


Figure 61 (Part 1 of 3). Minidisk Maps of the System Residence Device for 3380-E4 
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Minidisk Maps (3380-E4) 


LGLOPR 191 
CMSBATCH 195 
RSCS 191 
MAINT 36E 
$T-DISK$ B01 
MAINT = 391 
MAINT 291 
MAINT 19D 
MAINT 191 
OPERATOR 191 
OP1 191 


OPERATNS 191 
AUTOLOG1 191 
DISKACNT 191 


IBMPSR 191 
EREP 191 
MAINT 201 
MAINT 192 
MAINT 392 
MAINT 492 
MAINT 692 
MAINT 593 
MAINT 594 
MAINT 295 
MAINT 395 
MAINT 495 
MAINT 592 
MAINT 892 
MAINT 491 
MAINT 791 
MAINT B9E 
MAINT 896 
MAINT 895 


Figure 61 (Part 2 of 3). Minidisk Maps of the System Residence Device for 3380-E4 
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3380 
3380 


3380 
3380 
3380 
3380 
3380 
3380 


3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 


3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 
3380 


— 3380 


0493 
0494 

496 
0535 
0537 
0539 
0559 
0599 
0659 

688 
0703 
0719 
0724 
0725 
0742 
0743 
0744 
0745 

747 
0789 
0811 
0826 
0841 
0851 
0861 
0901 
0961 
0991 
1011 
1016 
1026 
1031 
1041 
1051 
1061 
1071 
1081 


0493 
0495 

534 
0536 


— 0538 


0558 


0598 © 


0658 
0687 

702 
0718 
0723 
0724 


0741 


0742 
0743 
0744 
0746 

788 
0810 
0825 
0840 
0850 
0860 
0900 
0960 
0990 
1010 
1015 
1025 
1030 
1040 
1050 
1060 
1070 
1080 
1107 


GAP 


GAP 


GAP 


GAP 


Minidisk Maps (3380-E4) 


MAINT 490 0072 
MAINT 423 0010 
MAINT 293 0060 
MAINT 294 | 0080 
MAINT 394 0130 
49 
MAINT 19C 0029 
MAINT 49c 0029 
MAINT 596 0020 
MAINT 59E 0010 
MAINT 591 0060 
MAINT 691 0040 
MAINT 49D 0029 
MAINT 501 0002 
MAINT 595 0012 
MAINT 123° 1770 **OVERLAP** 
SYSDUMP1 123 1770 **QOVERLAP** 


( & Figure 61 (Part 3 of 3). Minidisk Maps of the System Residence Device for 3380-E4 


| 
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USER DIRECT (3380-K) 


Sample Directory for 3380-K 


This is only a sample file. You need to tailor it to your installation before it can be used. 


KREKREKREKEKRRKREREKEREKRE KR KRERERERERRERERERRRERREKEEREREREERRERERERER 


ak Virtual Machine / System Product 5664-308  *** 
wee Contains restricted materials of IBM a ae 
wiek Copyright (c) I BM Corporation 1988 EA 
oP Licensed Materials - Property of I BM ae 


wae Refer to Copyright Instructions: Form G120-2083 wae 


KKEEKKEKEKEKEEKREREREKRERERRERERERREREERERERERERERERRREREEERRERERERRERE 
KKEKEKEEREKREERRKRKERKERERERERERREREREREKRERRERERRERERRERERERERERRERER 


3380-3 SYSTEM VM/XA SYSTEM PRODUCT DIRECTORY 

THE ADDRESSES 123, 124, AND 125 ARE VIRTUAL ADDRESSES. 

THE ADDRESS 123 IS CRITICAL SINCE IT IS USED IN HCPSYS AND 
THE DIRECTORY. IF YOU WANT TO CHANGE IT, REMEMBER IT MUST 
BE CHANGED IN HCPSYS, THE 'DIRECTORY' STATEMENT BELOW, 

AND IN THE ‘MDISK' STATEMENTS FOR THE USERID ‘MAINT’. 
NOTE: REMEMBER THESE ARE ONLY VIRTUAL ADDRESSES NOT REAL 
ADDRESSES, SO THERE IS NO NEED TO CHANGE THEM TO MATCH 


VALID LIADALIADE A 
IVUN HARUANARIL A 


THIS DIRECTORY MUST BE MODIFIED IF MDISK PASSWORDS ARE TO 
BE SPECIFIED. WITHOUT MDISK PASSWORDS, MDISKS CANNOT BE 

SHARED USING THE 'CP LINK' COMMAND. A SAMPLE USER ENTRY 

FOLLOWS: (NOTE ONLY THE MDISK STATEMENT) 


USER ANYONE SOMEPASS 3M 8M FG 
AUTOLOG AUTOLOG1 OP1 MAINT 


IPL 190 

CONSOLE Q1F 3215 

SPOOL O0C 2540 READER A 

SPOOL OOD 2540 PUNCH A 

SPOOL OOE 1403 A 

*e===>  MDISK 999 33XX XXX YYY ZZZZZZ MR RPASS WPASS MPASS 


4 FF FF HF HF F HF FF HF F HF F HF FF HF HF HK F 


 % + FFF HF HF FF HF KF HF FF HF HF HF HF HF F KH HF HF HK F KF HF F HF HF HF HF F 


* 

2 WHERE: RPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 

7 READ ONLY MODE. 

- WPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 

* WRITE MODE. 

ss MPASS WILL BE THE REQUIRED PASSWORD TO LINK IN 

* MULTI-WRITE MODE. 

* 

* NOTE: EACH PASSWORD MAY BE 1-8 CHARACTERS IN LENGTH. 

* 
KEKEKEEKKERERKERERKRKEKERERERKEKKREREKRKREKRKRERKRKRREKKRKREKRRREERERRRRERRRER 
* * 
* * 
* Following is a sample user entry and a brief description * 
* of each entry. A more detailed description may be found * 
* by referencing the VM/XA System Product Planning and * 
* Administration manual. * 
* * 
me USER CMS1 abcl123 3M 32MG 2 
. - Userid is CMS1 7 
" - Logon password is abcl23 i 
* - At logon time, virtual storage will equal 3M 
* - Maximum storage that may be defined equals 32M * 
* * 


- Privilege class is G 
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USER DIRECT (3380-K) 


AUTOLOG AUTOLOG1 OP1 MAINT 
- Allows user CMS1 to be autolog'd by AUTOLOGI, 
OP1, and MAINT 


ACCOUNT ACT4 CMSTST 
- Time used by CMS1 will be charged to account ACT4 
- Printed output will be sent to distribution CMSTST 


IPL CMS 
- Will cause automatic IPL of named save system of 
CMS 


CONSOLE 009 3215 
- Defines virtual machines console as a 3215 ata 
virtual address of 009 


SPOOL O0C 2540 READER A 
SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 
- Defines virtual unit record devices of reader, 
punch, and printer with a spooling class of 'A' 


LINK MAINT 190 190 RR 
- Allows read access to minidisk 190 of user 'MAINT' 


LINK MAINT 19E 19E RR 
- Allows read access to minidisk 19E of user 'MAINT' 


LINK MAINT 19D 19D RR 
- Allows read access to minidisk 19d of user 'MAINT' 


MDISK 999 3350 236 022 CPPACK WR RPASS WPASS 

- Defines minidisk with a virtual address of 999 

- Specifies that the minidisk resides on a real 3350 

- Minidisk starts at cylinder 236 

- Mdisk is 22 cylinders in size (starting at cyl 236 

- The real volume serial number is 'CPPACK' 

-~ Mdisk is to be accessed in write mode if no other 
user has write access. Alternate access read-only 

- RPASS is the required password for another user to 
link to this minidisk in read mode 

- WPASS is the required password for another user to 


link to this minidisk in write mode 
KEKE KEE KKKKK KKK KEKE REE ERRKRKRERRKRRRRERRRRKRRKREE 


¥ + % ¥ FF H HF F HF HF HF HF HF HF HF HF F HF HF HF HF HF SF HF K HF HF F HF HF HF H F H HF HF HF F HF HF HF HF K 
Fe FF FH * HF FF FH HF HF HF HF FF KF HF HF HK HF HF HK HF HF HF HF HF HF HF HF HF FH FF F HF HF HF 


* 
* 
* 


DIRECTORY 123 3380 XASRES 
* 


KREERERERERERKEKERERERKRRRKRRKRERKREKRERRERRERERRERERRRRRKERRERKEREKEEE 
ig SYSTEM RESERVED AREAS NOT FOR MINIDISKS : 
KEKIKEKREREKERERKRRERREKEKEREREREKERERREREREREKRREREKRERKRRERERKREEERE 
* 


USER $ALLOC$ NOLOG 

MDISK AO1 3380 000 001 XASRES R 
MDISK BO1 3380 Q00 001 XASERV R 
MDISK COQ1 3380 Q00 001 XAPOO1 R 


* 


USER $DIRECT$ NOLOG 
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833 


USER DIRECT (3380-K) 


MDISK AO4 3380 001 002 XASRES R 
* 

USER $CP-NUC$. NOLOG 

MDISK AO9 3380 003 010 XASRES R 
* 

USER $SYSCKP$ NOLOG 

MDISK AQ6 3380 013 002 XASRES R 
* 

USER $SYSWRM$ NOLOG 

MDISK AO7 3380 015 002 XASRES R 
* 

USER $PAGE$ NOLOG 

MDISK AQ3 3380 017 024 XASRES R 
* 

USER $SPOOL$ NOLOG 

MDISK BO1 3380 041 087 XASRES R 
* 

USER $T-DISK$ NOLOG 

MDISK BQ1 3380 539 020 XASRES R 


* 
ee ee ee ee eee Oe eee eee See eee eee eee eceeeeeeeee eee eee eee ee oy 
* CMS USERIDS * 
KEKKEKEKERKREKKERKEKRERERRERERREKREKRKKRERERERREKREEREREREREREKRERRERKE 
* 


USER CMS1 NOLOG 3M 32MG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT ACT4 CMSTST 

IPL CMS 

CONSOLE 009 3215 

SPOOL OOC 2540 READER A 
SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 


* 


KKREKRKREREREREREREEKREERERKERERERERRREREERERERRERERKERREERRERERERKRERKARKRREEKRE 


* PROP LOGICAL OPERATOR 


CLE TILT CCC TTL CCC CCL LT STE LL LSS SS Se See eT ee ee ee 


* 


USER LGLOPR NOLOG 512K 16M ABCDEG 
ACCOUNT ACT1 PROP 
IPL CMS 

CONSOLE 009 3215 

SPOOL OOC 2540 READER A 

SPOOL 90D 2540 PUNCH A 

“SPOOL QOE 1403 A 

MDISK 191 3380 493 001 XASRES WR 
LINK MAINT 194 194 RR 

LINK MAINT 190 190 RR 

LINK OPERATOR 191 291 RR 


* 
KREKREKKERERERRRKREERERERERREKRRREERRREERRERERREKRERERRERERERRERERERERE 
* SYSTEM RELATED USERIDS * 
ERKERKKERKEREERERERRERERERREEKERERRERRERRRERERRRERERREEKRREKEREREER 
* 


USER MAINT NOLOG 16M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 1 SYSPROG 
IPL 190 
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WY 


USER DIRECT (3380-K) 


NAMESAVE GCS 

NAMESAVE VTAM 

NAMESAVE HELP 

NAMESAVE INSTHELP 

CONSOLE 009 3215 T 

SPOOL O0C 2540 READER * 

SPOOL 00D 2540 PUNCH A 

SPOOL QOE 1403 A 

MDISK 123 3380 Q000 2655 XASRES MW 
MDISK 124 3380 0000 2655 XAPOO1 RR 
MDISK 125 3380 0000 2655 XASERV RR 


MDISK 191 3380 0703 016 XASRES MW 
MDISK 193 3380 0176 046 XASRES MW 
MDISK 194 3380 0406 056 XASRES MW 
MDISK 201 3380 0789 022 XASRES MW RMAINT WMAINT MMAINT 


MDISK 192 3380 0811 015 XASRES MW READ WRITE MULTIPLE 

MDISK 392 3380 0826 015 XASRES MW READ WRITE MULTIPLE 

cua MDISK 492 3380 0841 010 XASRES MW READ WRITE MULTIPLE 
( | MDISK 692 3380 0851 010 XASRES MW READ WRITE MULTIPLE 


MDISK 593 3380 0861 040 XASRES MW READ WRITE MULTIPLE 
MDISK 594 3380 0901 060 XASRES MW READ WRITE MULTIPLE 
MDISK 490 3380 0961 072 XASRES MW 
MDISK 423 3380 0166 010 XASRES MW 
MDISK 293 3380 1033 060 XASRES MW RCMSAUX WCMSAUX MCMSAUX 
MDISK 294 3380 1093 080 XASRES MW RCPAUX WCPAUX MCPAUX 
MDISK 393 3380 1829 056 XASRES WR 
are MDISK 394 3380 1173 130 XASRES WR 
( MDISK 19C 3380 1352 029 XASRES WR 
_ MDISK 49C 3380 1381 029 XASRES WR 
MDISK 596 3380 1410 020 XASRES WR 
MDISK 59E 3380 1430 010 XASRES WR 


MDISK 295 3380 1440 030 XASRES WR READ WRITE MULTIPLE 

MDISK 395 3380 1470 020 XASRES WR READ WRITE MULTIPLE 

MDISK 495 3380 1490 005 XASRES WR READ WRITE MULTIPLE 

MDISK 592 3380 1495 010 XASRES WR READ WRITE MULTIPLE 

MDISK 892 3380 1505 005 XASRES WR READ WRITE MULTIPLE 

( MDISK 491 3380 1510 010 XASRES WR READ WRITE MULTIPLE 
: MDISK 791 3380 1520 010 XASRES WR READ WRITE MULTIPLE 
MDISK 89E 3380 1530 010 XASRES WR READ WRITE MULTIPLE 

MDISK 896 3380 1540 010 XASRES WR READ WRITE MULTIPLE 

MDISK 895 3380 1550 010 XASRES WR READ WRITE MULTIPLE 


MDISK 391 3380 0306 040 XASRES MW 

MDISK 591 3380 1597 060 XASRES MW READ WRITE MULTIPLE 
MDISK 691 3380 1657 040 XASRES MW READ WRITE MULTIPLE 
MDISK 49D 3380 1697 029 XASRES MW READ WRITE MULTIPLE 
MDISK 501 3380 1726 002 XASRES MW READ WRITE MULTIPLE 
MDISK 291 3380 0346 060 XASRES MW 

MDISK 595 3380 1560 012 XASRES MW READ WRITE MULTIPLE 


MDISK 190 3380 0234 072 XASRES MW ALL 

MDISK 19E 3380 1756 044 XASRES MW ALL 

MDISK 19D 3380 1800 029 XASRES MW ALL 

* 

* MDISK STATEMENTS FOR INSTALL & SERVICE OF RSCS & PASS-THROUGH 
MDISK 36£ 3380 0537 002 XASRES RR RPVM WPVM MPVM 
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USER DIRECT (3380-K) 


LINK RSCS 191 499 MW 

* 

USER CMSBATCH NOLOG 1M 2M G 

ACCOUNT 3 SYSTEM 

OPTION ACCT 

IPL CMS PARM AUTOCR 
CONSOLE 009 3215 

SPOOL OC 2540 READER * 

SPOOL OOD 2540 PUNCH A 

SPOOL QOE 1403 A 

LINK MAINT 190 190 RR 

MDISK 195 3380 494 002 XASRES MR RBATCH WBATCH  MBATCH 
* 
USER GCS NOLOG 16M 16M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT GCS RECVM 

IPL GCS 
NAMESAVE GCS 
CONSOLE 009 3215 
SPOOL OOC 2540 READER * 
SPOOL AAD 2540 PUNCH A . 
SPOOL OOE 1403 A No 
LINK MAINT 190 190 RR 
LINK MAINT 19D 19D RR 

LINK MAINT 595 595 

LINK MAINT 59E 59E 
MDISK 191 3380 463 004 XASRES MR RGCS WGCS MGCS 


* 


USER SYSMAINT NOLOG = 3M 32M ABCDEFG 

AUTOLOG AUTOLOG1 OP1 MAINT _ 
ACCOUNT 1 SYSPROG -_ 

IPL CMS | ee 

CONSOLE 009 3215 T 

SPOOL OOC 2540 READER * 

SPOOL GOD 2540 PUNCH A 

SPOOL OOF 1403 A 

LINK MAINT 123 123 MW 

LINK MAINT 191 192 RR 

LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR | -_ 
* | 
USER OPERATOR NOLOG 16M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 

ACCOUNT 2 OPERATOR 

CONSOLE 009 3215 T 

SPOOL GOC 2540 READER * 

SPOOL OOD 2540 PUNCH A 

SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

MDISK 191 3380 719 005 XASRES MR 
LINK OP1 191 192 RR 


* 


*OP1 ITS AN ALTERNATE OPERATOR USERID 
* 

USER OP1 NOLOG 3M 32M ABCDEFG 
AUTOLOG AUTOLOG1 OP1 MAINT 

ACCOUNT 3 OPERATOR 


$36 Installation and Service 


USER DIRECT (3380-K) 


IPL CMS 

CONSOLE 009 3215 

SPOOL OOC 2540 READER * 

SPOOL 00D 2540 PUNCH A 

SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

MDISK 191 3380 724 001 XASRES MR 
LINK OPERATOR 191 192 RR 


This userid is for the IBM CE's use in running 
OLTSEP. 

OLTSEP is automatically IPLed in the virtual machine. 
A minimum machine size of one megabyte is required to 
run OLTSEP. 

The privilege class of F allows the CE to specify 
intensive recording mode. 

The console address of O1F is required by OLTSEP. 

The unit record addresses are those required by 
OLTSEP. 

The 5FF minidisk is the CE's OLTSEP pack. 


e+ + FF FF FF FE FF HF FF HH HF KF F 


USER OLTSEP NOLOG 3M 8M FG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT OLTSEP IBMCE 
IPL 5FF 
CONSOLE O1F 3215 
SPOOL OOC 2540 READER A 
SPOOL OOD 2540 PUNCH A 
SPOOL OOE 1403 A 
MDISK 5FF 3380 000 2655 CEPACK MR 


kk EREP *K* 


This userid is for the IBM CE's use in running 
CPEREP. 

CMS is automatically IPLed in the virtual machine. 
The 190 minidisk is the CMS system disk. 

The 191 minidisk may be used to save often-used EREP 
control statements and procedures (EXECs). 

THE 190 MINIDISK HAS THE CMS TXTLIBS NECESSARY TO RUN 
EREP. 


+e £ FF FF FF FF 


USER EREP NOLOG 3M 8M BFG 

AUTOLOG AUTOLOG1 OP1 MAINT 

ACCOUNT EREP IBMCE 

IPL CMS 

CONSOLE O1F 3215 

SPOOL OOC 2540 READER A 

SPOOL OOD 2540 PUNCH B 

SPOOL OQE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 201 201 RR 

MDISK 191 3380 745 002 XASRES WR READ WRITE MULTIPLE 

* 

USER OPERATNS NOLOG 3M 8M BCEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 1 OPERATNS 
TPL CMS 


Appendix C. VM/XA System Product Starter System Information 


837 


USER DIRECT (3380-K) 


CONSOLE 009 3215 

SPOOL O0C 2540 READER D 

SPOOL OOD 2540 PUNCH A 

SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 

LINK MAINT 19E 19E RR 

LINK MAINT 19D 19D RR 

MDISK 191 3380 725 017 XASRES MR RDVF WDVF MDVF 


* 
* 


USER IPCS NOLOG 3M 8M BCEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 8 CE-ROOM 

IPL CMS 

CONSOLE 009 3215 

SPOOL @OC 2540 READER * 
SPOOL 00D 2540 PUNCH A 
SPOOL QOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
LINK OPERATNS 193 192 RR 

* 

USER AUTOLOG1 NOLOG 3M 8M ABCDEG 
AUTOLOG OP1 MAINT 
ACCOUNT 9 SYSTEM 

IPL CMS 
CONSOLE 009 3215 
SPOOL O0C 2540 READER * 
SPOOL 00D 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 190 190 RR 
MDISK 191 3380 742 001 XASRES MR RAUTOLOG WAUTOLOG MAUTOLOG 

* 

USER DISKACNT NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 10 ACCNTNG 

IPL CMS 
CONSOLE 009 3215 
SPOOL @OC 2540 READER * 
SPOOL @@D 2540 PUNCH A 
SPOOL QOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 191 3380 743 001 XASRES MR READ WRITE MULTIPLE 

* 

USER IBMPSR NOLOG 3M 8M BG 
ACCOUNT 10 ACCNTNG 

IPL CMS 
CONSOLE 009 3215 
SPOOL O0C 2540 READER * 
SPOOL @@D 2540 PUNCH A 
SPOOL OOF 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 191 3380 744 001 XASRES WR 


* 


USER IVPM2 NOLOG 3M 4M G 
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USER DIRECT (3380-K) 


AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT ACTS IVPM2 
( ’ CONSOLE 009 3215 
kad SPOOL OOC 2540 READER A 
SPOOL 60D 2540 PUNCH A 
SPOOL OOE 1403 A 
LINK MAINT 194 194 RR 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
* 
USER VMUTIL NOLOG 3M 8M BDEG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 11 SYSTEM 
IPL CMS 
CONSOLE 009 3215 
SPOOL O0C 2540 READER * 
SPOOL 00D 2540 PUNCH A 
co SPOOL O0E 1403 A 
( | LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
* 
USER SYSDUMP1 NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 12 SYSTEM 
IPL CMS 
CONSOLE 009 3215 
— SPOOL @0C 2540 READER * 
( SPOOL 00D 2540 PUNCH A 
a SPOOL O0E 1403 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 123 3380 000 2655 XASRES RR 
MDISK 124 3380 000 2655 XAPQO1 RR 
MDISK 125 3380 000 2655 XASERV RR 


* 


> 


* 


_ USER RSCS NOLOG 3M 8M BEG 
( AUTOLOG AUTOLOG1 OP1 MAINT 
ACCOUNT 13 SYSTEM 
NOPDATA 
IPL 191 


CONSOLE 609 3215 
SPOOL GC 2540 READER * 
SPOOL @0D 2540 PUNCH A 
SPOOL QOE 1403 A 
LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
MDISK 191 3380 535 002 XASRES MR RRSCS -WRSCS —-MRSCS 
x 
USER PVM NOLOG 3M 8M BG 
AUTOLOG AUTOLOG1 OP1 MAINT 
7 ACCOUNT 14 SYSTEM 
‘ IPL CMS 
CONSOLE 009 3215 
SPOOL OOC 2540 READER * 
SPOOL @@D 2540 PUNCH A 
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USER DIRECT (3380-K) 


SPOOL OOE 1403 A 

LINK MAINT 190 190 RR 
LINK MAINT 19E 19E RR 
LINK MAINT 19D 19D RR 
LINK MAINT 36E 191 MR 


* 


* 
KRERKKRKREKERKEKRRERKERERERREKRRERERERRRREKERKRRERERERREKREKREREKRERRRKERKRERE 
* OTHER OPERATING SYSTEM USERIDS * 
KEKRKEKREKRKKEKRREKEKREREKREKRERKKREKREKERKEKERREREKREREKRRKERERKERERKRRREKEERE 
* 


NL 


fe aS 
/ 


$40 Installation and Service 


XAMAINT Directory Entry (3380-K) 


Sample XAMAINT Directory Entry for 3380-K 


( ; If you are using the procedure in Chapter 4, “Installing VM/XA System Product Release 2 Using an Existing 
ees VM/SP or VM/SP HPO System” on page 219 to install your system, add the following entry to your 
directory: 


* 


USER XAMAINT NOLOG 16M 16M ABCDEFG 
OPTION ECMODE DIAG98 

ACCOUNT 1 SYSPROG 

IPL 190 
*NAMESAVE GCS 
*NAMESAVE VTAM 
*NAMESAVE HELP 
*NAMESAVE INSTHELP 

CONSOLE 009 3215 T 

SPOOL QOC 2540 READER * 

SPOOL QOD 2540 PUNCH A 

es SPOOL OOE 1403 A 
( MDISK 123 3380 0000 2655 XASRES MW 
MDISK 124 3380 0000 2655 XAPOQ1 RR 
MDISK 125 3380 0000 2655 XASERV RR 


MDISK 191 3380 0703 016 XASRES MW 
MDISK 193 3380 0176 046 XASRES MW 
MDISK 194 3380 0406 056 XASRES MW 
MDISK 201 3380 0789 022 XASRES MW RMAINT WMAINT MMAINT 


aides MDISK 192 3380 0811 015 XASRES MW READ WRITE MULTIPLE 
( | MDISK 392 3380 0826 015 XASRES MW READ WRITE MULTIPLE 

a MDISK 492 3380 0841 010 XASRES MW READ WRITE MULTIPLE 
MDISK 692 3380 0851 010 XASRES MW READ WRITE MULTIPLE 


MDISK 593 3380 0861 040 XASRES MW READ WRITE MULTIPLE 

MDISK 594 3380 0901 060 XASRES MW READ WRITE MULTIPLE 

MDISK 490 3380 0961 072 XASRES MW 

MDISK 423 3380 0166 010 XASRES MW 

MDISK 293 3380 1033 060 XASRES MW RCMSAUX WCMSAUX MCMSAUX 

MDISK 294 3380 1093 080 XASRES MW RCPAUX WCPAUX MCPAUX 
a MDISK 393 3380 1829 056 XASRES WR 

( 7 MDISK 394 3380 1173 130 XASRES WR 

MDISK 19C 3380 1352 029 XASRES WR 

MDISK 49C 3380 1381 029 XASRES WR 

MDISK 596 3380. 1410 020 XASRES WR 

MDISK 59E 3380 1430 010 XASRES WR 


a 


MDISK 295 3380 1440 030 XASRES WR READ WRITE MULTIPLE 
MDISK 395 3380 1470 020 XASRES WR READ WRITE MULTIPLE 
MDISK 495 3380 1490 005 XASRES WR READ WRITE MULTIPLE 
MDISK 592 3380 1495 010 XASRES WR READ WRITE MULTIPLE 
MDISK 892 3380 1505 005 XASRES WR READ WRITE MULTIPLE 
MDISK 491 3380 1510 010 XASRES WR READ WRITE MULTIPLE 
MDISK 791 3380 1520 010 XASRES WR READ WRITE MULTIPLE 
MDISK 89E 3380 1530 010 XASRES WR READ WRITE MULTIPLE 
MDISK 896 3380 1540 010 XASRES WR READ WRITE MULTIPLE 
MDISK 895 3380 1550 010 XASRES WR READ WRITE MULTIPLE 


MDISK 391 3380 0306 040 XASRES MW 
MDISK 591 3380 1597 060 XASRES MW READ WRITE MULTIPLE 
MDISK 691 3380 1657 040 XASRES MW READ WRITE MULTIPLE 
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XAMAINT Directory Entry (3380-K) 


MDISK 49D 3380 1697 029 XASRES 
MDISK 501 3380 1726 002 XASRES 
MDISK 291 3380 0346 060 XASRES 
MDISK 595 3380 1560 012 XASRES 


MDISK 190 3380 0234 072 XASRES 
MDISK 19E 3380 1756 044 XASRES 
MDISK 19D 3380 1800 029 XASRES 


* 


* MDISK STATEMENTS FOR INSTALL & SERVICE OF RSCS & PASS-THROUGH 


MW READ WRITE MULTIPLE 
MW READ WRITE MULTIPLE 
MW 

MW READ WRITE MULTIPLE 


MW ALL 
MW ALL 
MW ALL 


MDISK 36E 3380 0537 002 XASRES RR RPVM WPVM MPVM 


LINK RSCS 191 499 MW 
LINK MAINT 190 390 RR 


* 
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ae 


XASRES Volume Allocation (3380-K) 


System Residence DASD Allocation for 3380-K 


Figure 62 shows the allocation for the system residence device for the 3380-K VM/XA SP Starter System. 


TYPE CYL CYL 
PERM 0000-0000 
DRCT 0001-0002 
PERM 0003-0013 
PAGE 0014-0037 


SPOL 0038-0074 
PERM 0075-0197 
TDSK 0198-0216 
PERM 0217-2654 


Figure 62. System Residence DASD Allocation for 3380-K 
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Minidisk Maps (3380-K) 


Minidisk Maps for 3380-K System Residence Device 


Figure 63 shows the minidisk maps of the system residence device for the 3380-K. To map your own system 
residence device for comparison, issue DISKMAP fn DIRECT, where /m is the name of your directory. 


VOLUME 
CEPACK 


USERID 
OLTSEP 


3380 


VOLUME 
XAPQ01 


USERID 
$ALLOC$ 
MAINT 
SYSDUMP1 


**QVERLAP** 
**QVERLAP** 


VOLUME 
XASERV 


USERID 
$ALLOC$ 
MAINT 
SYSDUMP1 


**QVERLAP** 
**QVERLAP** 


VOLUME 
XASRES 


USERID 


$ALLOC$ | 


$DIRECT$ 
$CP-NUC$ 
$SYSCKP$ 
$SYSWRM$ 
$PAGE$ 
$SPOOL$ 


MAINT 
MAINT 


MAINT 
MAINT 
MAINT 
MAINT 


AQ7 
A03 
BO1 


423 
193 


190 
391 
291 
194 


DEVTYPE 


3380 
3380 
3380 
3380 
3380 
3380 
3380 


3380 
3380 


3380 
3380 
3380 
3380 


GAP 


GAP 


GAP 


Figure 63 (Part 1 of 3). Minidisk Maps of the System Residence Device for 3380-K 
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Minidisk Maps (3380-K) 


GCS 191 3380 0463 0466 0004 

46/7 492 26 GAP 
LGLOPR 191 3380 0493 0493 0001 
CMSBATCH 195 3380 0494 0495 0002 

496 534 39 GAP 
RSCS 191 3380 0535 0536 0002 
MAINT 36E 3380 0537 0538 0002 
$T-DISK$ B01 3380 Q539 0558 0020 

559 702 144 GAP 
MAINT 191 3380 0703 0718 0016 
OPERATOR 191 3380 0719 0723 0005 
OP1 191 3380 0724 0724 0001 


OPERATNS 191 3380 0725 0741 0017 
AUTOLOG1 191 3380 0742 0742 0001 
DISKACNT 19] 3380 0743 0743 0001 


IBMPSR 191 3380 0744 0744 0001 
EREP 191 3380 0745 0746 0002 
os 747 788 42 GAP 
( MAINT 201 3380 0789 0810 0022 
MS MAINT 192 3380 0811 0825 0015 
MAINT 392 3380 0826 0840 0015 
MAINT 492 3380 0841 0850 0010 
MAINT 692 3380 0851 0860 0010 
MAINT 593 3380 0861 0900 0040 
MAINT 594 3380 0901 0960 0060 
MAINT 490 3380 0961 1032 0072 
MAINT 293 3380 1033 1092 0060 
_ MAINT 294 3380 1093 1172 0080 
( “ MAINT 394 3380 1173 1302 0130 
Ee oe 1303 1351 49 GAP 


Figure 63 (Part 2 of 3). Minidisk Maps of the System Residence Device for 3380-K 
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Minidisk Maps (3380-K) 


MAINT 


MAINT 49C 3380 1381 1409 0029 
MAINT 596 3380 1410 1429 0020 
MAINT 59E 3380 =: 1430 1439 0010 
MAINT 295 3380 1440 1469 0030 
MAINT 395 3380 1470 1489 0020. 
MAINT 495 3380 1490 1494 0005 
MAINT 592 3380 1495 1504 0010 
MAINT 892 3380 1505 1509 0005 
MAINT 491 3380 1510 1519 0010 
MAINT 791 3380 1520 1529 0010 
MAINT 89E 3380 1530 1539 0010 
MAINT 896 3380 1540 1549 0010 
MAINT 895 3380 1550 1559 0010 
MAINT 595 3380 1560 1571 0012 
1572 1596 25 GAP 
MAINT 591 3380 1597 1656 0060 
MAINT 691 3380 1657 1696 0040 
MAINT 49D 3380 1697 1725 0029 


MAINT 501 


MAINT 19E 
MAINT . 19D 3380 1800 1828 0029 
MAINT 393 3380 1829 1884 0056 
MAINT 123 3380 0000 2654 2655 **OVERLAP** 
SYSDUMP1 123 2655 **QVERLAP** 


Figure 63 (Part 3 of 3). Minidisk Maps of the System Residence Device for 3380-K 
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Sample SPLOAD PROFILE 


SPLOAD PROFILE 


Information about the product tape layout, fields for userid, minidisk address, format, volume number and 
tape number are contained in this profile. The following is an example of the SPLOAD profile for the 3420 
(6250 BPI) tape. 


! Volume 1 


Memo Files MAINT 191 XASP20V1 1 2 
Install Tools MAINT 191 XASP20V1 1 3 
Sysgen Tools MAINT 193 XASP20V1 1 4 
System Samples MAINT 191 XASP20V1 1 5 
CPLOC Samples MAINT 295 XASP20V1 1 6 
CMSLOC Samples MAINT 395 XASP20V1 i 7 
CP Object MAINT 194 XASP20V1 1 8 
CP Putapply MAINT 192 XASP20V1 1 9 
CP Putdelta MAINT 294 XASP20V1 1 10 
CP Corapply MAINT 291 XASP20V1 1 11 
CP Cordelta MAINT 291 XASP20V1 1 12 
DUMPVIEW Object MAINT 193 XASP2QV1 1 13 
DUMPVIEW Putapply MAINT 392 XASP20V1 1 14 
DUMPVIEW Putdelta MAINT 293. XASP20V1 1 15 
DUMPVIEW Corapply MAINT 391 XASP20V1 1 16 
DUMPVIEW Cordelta MAINT 391 XASP20V1 1 17 
! 

! Volume 

CMS Base MAINT 193 XASP20V2 2 2 
CMS Putapply MAINT 392 XASP2O0V2 2 3 
CMS Putdelta MAINT 293. + XASP20V2 2 4 
CMS Corapply MAINT 391 XASP20V2 2 5 
CMS Cordelta MAINT 391 XASP20V2 2 6 
IOCP Files MAINT 193 XASP20V2 2 7 
CMS System MAINT 190 XASP20V2 2 8 
GCS Object MAINT 595 XASP20V2 2 9 
GCS Interface MAINT 193 XASP20V2 2 10 
GCS Putapply MAINT 592 XASP20V2 2 11 
GCS Putdelta MAINT 596 XASP20V2 2 12 
GCS Corapply MAINT 491 XASP20V2 2 13 
GCS Cordelta MAINT 491 XASP20V2 2 14 
AMENGHLP Files MAINT 19D XASP20V2 2 15 
UCENGHLP Files MAINT 19C =XASP20V2 2 15 
! Volume 

I 

CP Source MAINT 394 XASP20V3 3 2 
CMS Source MAINT 393. XASP20V3 3 3 
DUMPVIEW Source MAINT 393 XASP20V3 3 4 
1 

! 

i= ee ia es arin capes vee Sapa ate each Staal a tect cS ak te aN ati ho RE Sa tg ete oe eS aS | 
i= 6250 BPI VM/XA NLS Feature Tape x 
i> a ae as Rhee ees cae are eet oe oe as SiR a as eet ot cae a ee ee ee a 
pe a 
CMS Base MAINT 193 R2MONLS 1 2 
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Object 
Files 

Source 
Object 
Object 


MAINT 
MAINT 
MAINT 
MAINT 
MAINT 
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R2MONLS 
R2MONLS 
R2MONLS 
R2MONLS 
R2MONLS 


a ee 


“SD OF LS OC 


* 


aa 


Appendix D. Listing CP Data Areas and Control Blocks 


You can get a listing of CP data areas and control blocks written in ASSEMBLER by assembling a file 
called HCPBLOKS ASSEMBLE. (Data areas and control blocks in PLAS are not listed). Follow these 


steps: 


1. Log onto the MAINT user ID. 


2. Define a temporary disk. Use the chart below to determine how much DASD space you need: 


Device (devtype) Cylinders (cyls) 
3330 22 
3350 10 
3375 16 
3380 10 


def devtype vdevno cyls @ 


DASD vdevno DEFINED 
Ready; T=n.nn/n.nn hh:mm:ss 


3. Format the temporary minidisk and access it as A. 


format vdevno a @ 


FORMAT WILL ERASE ALL FILES 

ON DISK 'A(vdevno)'. DO YOU WISH 
TO CONTINUE? (YES|NO): 

yes 

ENTER DISK LABEL: 


label @ 

FORMATTING DISK 'A'. 

nn CYLINDERS FORMATTED ON ‘A(vdevno)'. 
Ready; T=n.nn/n.nn hh:mm:ss 


Substitute a device type for devtype, a virtual 
device number for vdevno, and a cylinder count 
for cyls. 


Substitute the virtual device number for 
vdeyno. 


Enter your own disk label for this temporary | 
disk. 


4. Access MAINT’s 394 minidisk (the CP source file disk) and copy the HCPBLOKS ASSEMBLE file. 


access 394 c Hf 
Ready; T=n.nn/n.nn hh:mm:ss 


copy hcpbloks assemble c (olddate unpack @ 
Ready; T=n.nn/n.nn hh:mm:ss 


You must access 394 as C. The file you copy 
is in packed format. Use the UNPACK 
option to unpack the file. 
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5. Access MAINT’s 194 minidisk (the control file and MACLIB disk) and 294 minidisk (the update file 
disk). 


access 194 b/a 


B (194) R/O 
=n.nn/n.nn hh:mm:ss 


Ready; 


access 294 c/a Hi 


'294' REPLACES ' C (394) ' 


C (294) R/O 


Ready; T=n.nn/n.nn hh:mm:ss 


6. Reaccess MAINT’s 394 minidisk as a read-only extension to MAINT’s A minidisk. — 


access 394 d/a @ 
D (394) R/O 


Ready; T=n.nn/n.nn hh:mm:ss 


7. Check MAINT’s minidisk access order. The minidisks, access modes, and link mode (R/W or R/O) 


should be ine same as shown. 


query search @ 


label 

MNT194 
MNT294 
MNT394 
MNT190 
MNT19E 


Ready; T=n.nn/n.nn hh:mm:ss 


vdevno A 
194 B/A 
294 C/A 
394 D/A 
190 S 
19E Y/S 


R/W 
R/O 
R/O 
R/O 
R/O 
R/O 


label and ydevno are the values you substituted 
when you defined and formatted the temporary 
minidisk. 


8. Use the UPDATE command to update HCPBLOKS ASSEMBLE: 


update hcpbloks assemble * hcpxa cntr1 * (ctl @ 


UPDATING ‘HCPBLOKS ASSEMBLE D1' 


APPLYING 'HCPBLOKS ft 
Ready; T=n.nn/n.nn hh:mm:ss 


C1' 


This example assumes there is an update file 
for HCPBLOKS. If there is an update file, it 
will have a special file type (ft). If there is no 
update file, you will receive the message NO 
UPDATE FILES WERE FOUND. | 


9. Issue the GLOBAL command for the macro libraries called by HCPBLOKS: 


global maclib hcpxa dmssp cmslib osmacro osmacrol 
Ready; T=n.nn/n.nn hh:mm:ss 


10. Set the virtual punch to stay open after spool files reach 50,000 records: 


850 


spool punch noeof @ 


Installation and Service 


The option NOEOF means the punch stays 
open after punch spool files reach 50,000 
records. 


11. Issue the HASM command for HCPBLOKS: 


( ; hasm fn (sysparm (exp) xref (full) print @ If updates were applied to HCPBLOKS 
a ASSEMBLE, substitute $HCPBLOK for fn. If 
updates were not applied to HCPBLOKS 
ASSEMBLE, substitute HCPBLOKS for fn. 


PRT FILE spoolid SENT FROM MAINT PRT AS spoolid RECS nnnn COPY 001 A NOHOLD NOKEEP 
Ready; T=n.nn/n.nn hh:mm:ss 
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Appendix E. Example of Alternate GCS Nucleus Placement 


Overview 


This appendix demonstrates how to save your GCS system at a virtual storage location other than the one 
provided by the product tape samples. You might want the GCS segment at a different location, depending 
on the other segments being used by your GCS group. 


This section also describes how to increase the size of the GCS saved system. One reason that you might 
want to do this is to increase the amount of available common storage. Refer to VM/XA SP Planning and 
Administration for information about calculating common storage requirements for GCS. 


To relocate your GCS saved system and change its size, you need to: 


e Change the SLC names in the GCSLOAD EXEC 

¢ Create SLC files to contain the new address locations 

¢ Modify the DEFSYS entries in the SAMPNSS EXEC for GCS 
e Build and save the GCS nucleus. 
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Procedure 


This sample procedure demonstrates how to relocate your GCS saved system in a 16-megabyte virtual 


machine. Originally 2M in size and loaded at X'400000', the segment is moved to X'800000' and increased 


in size to 3MB. 
1. Log on as MAINT and access the GCS system disk: 


access 595 a & 


2. Modify the GCS loadlist (GCSLOAD EXEC A) and change the Set Location Counter (SLC) values that 


determine where the shared portion of GCS is loaded into virtual storage. 


In the commands that follow, “SLC L400000” is the name of a CMS file that contains the address of the 


starting location for loading the main portion of the GCS nucleus. This SLC statement precedes the 
CSIALP entry in the loadlist. “SLC L600000” marks the end of the GCS nucleus (also the end of 


common storage), and it precedes the CSIZET entry. 


Note: The GCS loadlist may be changed by service. After applying a PUT, you should check the file 
and change it if necessary before you rebuild the GCS nucleus. 


Enter the following commands: 


xedit gcsload EXEC a @ 

set case upper 

top & 

change / SLC L400000 / SLC L800000 /* @ 
top @ 

change / SLC 1600000 / SLC LBQ0000 /* @ 
file Bi 


3. Create two new SLC files to match the new loadlist: 


xedit SLC 1800000 a 


input $SLC 800000 @ 
set hex on # 


change /$/X'02'/ @ 
file & 
xedit SLC LB0Q000 a 


input $SLC B0e0000 @ 


set hex on Hf 
change /$/X'02'/ @ 
file @ 
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There must be two blanks between SLC and 
the address. 


X'02' is an unprintable loader control 
character. 


There must be two blanks between SLC and 
the address. 


X'02' is an unprintable loader control 
character. 


a 
fF 
ae 


4. Modify the DEFSYS entry for your GCS saved system in the SAMPNSS EXEC. As a result, you may 


also have to change other DEFSYS entries. In this example, the new location for GCS overlays the . 
default locations for CMSVSAM and CMSAMS, so you will have to change those entries. 


Note: To convert an entry in the system name table of a VM/SP or VM/SP HPO system to a DEFSYS 
entry, see VM4/XA SP Conversion Notebook. 


The IBM-supplied DEFSYS entry for GCS in the SAMPNSS EXEC looks like this: 
'CP DEFSYS GCS 0-6 EW 400-5FF SW MINSIZE=256K VMGROUP RSTD' 
GCS occupies pages 400 through 5FF (all of segments 4 and 5). 

a. Calculate the new values for the DEFSYS entry: 


1) To calculate the page number where the GCS nucleus begins, divide the corresponding SLC 
value (X'800000' in this example) by the page size, X'1000'. The result is X'800'. 


2) To calculate the page number where GCS ends, divide the corresponding SLC value (X'B00000' 
in this example) by X'1000' and subtract one. The result is X'AFF'. 


b. XEDIT the SAMPNSS EXEC and enter the new values in the DEFSYS entry for GCS. The 
changed entry looks like this: 


'CP DEFSYS GCS 0-6 EW 800-AFF SW MINSIZE=256K VMGROUP RSTD‘ 


. Copy the latest version of the product parameter file to the 191 minidisk: 


copy 56643082 $ppf fm = = a (replace @ 


. Generate and save the GCS nucleus: 


access 495 c You do not want to change the nucleus on the 
595 disk. 


Note: 


. Before you generate the nucleus, you may want to use GROUP EXEC to create a new GCS 


configuration file for this nucleus. See the GCS step in the installation procedure. 


itask build gcs systemname @ If you do not specify a systemname, the default 
ip] cms @ is GCS. 


Appendix E. Example of Alternate GCS Nucleus Placement 855 


a 


a . 
\ 
Na 


Appendix F. Restricted Logon Passwords 


The CP nucleus includes a system security feature called ADRP (Auto-Deactivation of Restricted Passwords). 
ADRP works with a CMS file named RPWLIST DATA that contains the list of restricted logon passwords 
shown in Figure 64. You can edit this file to add your own restricted passwords. 


Issuing the DIRECTXA command causes the system to search the directory for the restricted passwords 
contained in this list. All passwords that match are changed to NOLOG in the directory before the directory 
is placed online. You cannot log on to any user ID whose password has been changed to NOLOG. 
Therefore, make sure that you have changed all restricted passwords in the directory to unique non-restricted 
passwords before you issue the DIRECTXA command. 


ACNT KHEKKKEKKREREKEKREEKKREKRKEKEREEKREKEKREEEEEEKREREEEREREEKKEREKKKEKKE 


AUTOLOG * THIS MODULE IS RESTRICTED MATERIALS OF IBM. . 

ee AUTOLOG1 * 5664-308 (C) COPYRIGHT IBM CORPORATION - 1988 . 
(. BATCH * LICENSED MATERIALS - PROPERTY OF IBM | . 
eo CE * SEE COPYRIGHT INSTRUCTIONS, G120-2083 . 


CMSUSER KKEKEKKEKEKEKEKERERERRERRER KEKE ER KREKEEKREKEKERRERERRERERERREERKKRKRESE 


MS1 
ac KKEKKKKEKEKKKEKEKRKKEKKEKKKKKRKKEKEREKEKKREKRERKKERRRKKREKEERKRERKEEKKKRRKKE 
CMS3 
CPCMS 
DIRM 
ECMODE 
GCS 
pe, IBMCE 
(_ 1PCs 
- ISMAINT 
ITPS 
IVPASS 
LEV2VM 
MAINT 
MASTER 
MDVR KEEKKKEKRRKKREKRKREKEKRRKERKEEKEEKREERRRERKKRRERERRKRERREKRERKERRKRRRRAKEKEE 
OPASS 
= OPERATNS 
( | OPERATOR 
-* OSVS1 
PASSWORD 
PRODBM 
PROMAIL 
PSR 
ROUTER 
RSCS 
SFBATCH 
SSFCAL 
SQLDBAPW 
SQLUSER 
SYSADMIN 
SYSDUMP 
VMAP 
VSEIP 
VSEIPO 
VSEMAINT 


Restricted Password List 
Format Rules: 


1) The RPWLIST DATA file must be fixed record length 
format, with a record length of at least 8. 

Each password must start in column 1. 

3) Columns 1-8 must contain restricted passwords only. 
4) Each line may contain only one password. 

5) Column 9 must contain a blank. 

6) Columns 10 through 80 may be used for comments, such 
as this prologue. 


+ oF FF Fe F FF F FF HF F 
N 
a 

% * + + FF FF F HF OF YF 


* 


Figure 64. RPWLIST DATA File 
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Appendix G. Controlling Disk String Merges 


Automatic Merging 


VMFREC normally merges the alternate DELTA, APPLY, and LOCAL minidisks to their corresponding 
current disks, in accordance with the :MERGE. tag in the product parameter file. 


Since disks are merged only within a string (for example, DELTA disks are merged to DELTA disks, not to 
APPLY disks), merging does not consolidate the contents of all disks, but saves back levels of service on the 
current disks and frees the alternate disks for new levels of service. Merging also frees the alternate DELTA 
disk, because VMFREC loads a new level of service files there. 


Note: When you apply corrective service, the DELTA and APPLY disk strings are redefined to consist of 
the LOCAL] disks in the temporary product parameter file. This redefinition is necessary in order for 
VMFREC to load files to the LOCAL1 disk. It is done automatically by the corrective service 
overrides in the product parameter file. 


Preventing Automatic Merging 


You may not want VMFREC to merge a certain disk string. A common reason is that you apply local 
service on a different schedule from program update service and corrective service, and you want to keep 
your LOCALI disks unchanged. 


To prevent VMFREC from merging a string, define and format a minidisk at any address you are not using. 
Don’t put anything on this minidisk. Then put this disk at the head of the string you don’t want to merge in 
the product parameter file. (Remember that if you are processing corrective service, you must make the 
change in the corrective override section of the product parameter file, not in the base.) When VMFREC 
finds an empty disk at the head of the string, it will not do the merge. 


If you do not want VMFREC to merge any disk strings at all, remove all the symbolic disk string names 
from the :MERGE. tag in the product parameter file. For example, change: 

sMERGE. DELTA1 APPLY LOCAL1 

to: 


:MERGE 


Manual Merge Procedure 


For Program Update Service 
For the addresses of the DELTAI, APPLY, and LOCALI minidisks merged in this procedure, see Figure 6 
on page 364. 


1. Copy the contents of the alternate DELTAI disk to the current DELTAI disk, using the REPLACE 
option. 


2. Erase all the contents of the alternate DELTA! disk. When VMFREC finds this disk empty, it will not 
merge the DELTALI string. 


3. Copy the contents of the alternate APPLY disk to the current APPLY disk, using the REPLACE option. 
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4. Erase all the contents of the alternate APPLY disk. When VMFREC finds this disk empty, it will not — 
merge the APPLY string. 


5. Copy the contents of the intermediate alternate LOCAL] disk to the current LOCALI disk, using the 
REPLACE option. 


6. Erase all the contents of the intermediate alteniate LOCALI disk. 


7. Copy the contents of the alternate LOCAL1 disk to the intermediate alternate LOCAL1 disk, using the 
REPLACE option. 


8. Erase all the contents of the alternate LOCAL1 disk. When VMFREC finds this disk empty, it will not 
merge the LOCAL] string. 


For Corrective Service 


For the addresses of the LOCAL1 minidisks merged in this procedure, see Figure 6 on page 364. 


1. Copy the contents of the intermediate alternate LOCAL! disk to the current LOCALI disk, using the 
REPLACE option. a 


Z. Erase ail the contents of the intermediate alternate LOCALI disk. 


a 
% 


3. Copy the contents of the alternate LOCALI disk to the intermediate alternate LOCALI disk, using the 
REPLACE option. 


4. Erase all the contents of the alternate LOCAL1 disk. When VMFREC finds this disk empty, it will not 
merge the LOCAL] string (which also serves as the DELTAI and APPLY strings during corrective 
service). 


+ ea 
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Appendix H. Service Reference Tables 


VM/XA SP File Types and Abbreviations 


The first column of Table 22 shows the 3-character abbreviations conventionally used for the file names in 
the second column. These abbreviations are used 1n the file type of parts supplied for service (see “Parts 
Supplied For Service and What to Do with Them” on page 863). 


Table 22 (Page 1 of 2). VM/XA SP File Types 


Table 22 (Page 1 of 2). VM/XA SP File Types 
and Abbreviations 


Abbreviated File Type Complete File Type 


HED 


HELPDUMP 


and Abbreviations 


Abbreviated File Type 


HEP 


S 


Q 


S 
S 
S 
S 


a! mz 


an 
Ala 


W 
xX 


ES ie 
0} 
< 


Z) m0] 4 a ws | oon ie 


re 
wv) 
re 


Complete File Type 
HELP 
HELPEXEC 
HELPEXC2 
HELPGROU 
HELPHELP 
HELPINDI 


ee 
= 
ro 


HELPMACR_ 
HELPMENU 
HELPMONI 
HELPCMSQ 
HELPMSG 
HELPPF 
HELPPREF 
HELPPURG 
HELPQUER 
HELPREXX 
HELPSET 
HELPSRPI 
HELPCMSS 
HELPSTOR 
HELPTRAC 
HELPTASK 
HCPSADWT 
HELPXEDI 
LANGUAGE 
LOADMAP 
LOADER 
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TS SE 


and Abbreviations | 
L50 


L500000 


MLB 
MOD 


MACLIB 
MODULE 
PROFILE 


SAMPEXEC 
SAMPLIST 


XEDIT 
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Parts Supplied For Service and What to Do with Them 


Table 23 shows the parts that IBM will supply for service to each part of your system. The first column 
identifies the part to be serviced by file type. The second column shows whether that kind of part is serviced 
by update, replacement, or both. The third and fourth columns list the parts that IBM will send you when 
you apply corrective service and program update service respectively. The fifth column shows the parts 
required for update service: the source file (for example, an ASSEMBLE file), which you already have, the 
update, which is supplied on the COR or PUT tape, and the auxiliary control file, which is generated during 
the service process. The sixth column shows the most important EXECs and commands you will use in 
rebuilding the serviced part. (For full instructions, see Chapter 13, “Rebuilding CMS after Applying 
Service” on page 457, Chapter 14, “Rebuilding CP after Applying Service” on page 515, Chapter 15, 
“Program Update Service or Corrective Service to the Dump Viewing Facility” on page 537, or Chapter 16, 
“Program Update Service or Corrective Service to GCS” on page 547.) If the sixth column is blank, the part 
supplied by IBM simply replaces the one you already have. If you want to keep your own part for reference, 
you can rename it. 


( : Table 23 (Page 1 of 2). Parts Supplied For Service and What to Do with Them 


Usable Form Update or Parts For Parts For Update Parts Build Function 
Replace? COR Service PUT Service 


EXEC Update update update update EXECUPDT 
$EXEC AUXXA AUXXA AUXXxxxx 
EXCnnnnn EXCnnnnn $EXEC Copy fn 
EXEC EXEC EXCnnnnn fm 
$EXnnnnn' $EXnnnnn’* = EXEC =? 
$EXEC! $EXEC? 


Copy fn 
EXCnnnnn fm 


= EXEC = 


( ) Replace EXCnnnnn EXCnannn 
; EXEC EXEC EXEC 


XEDIT Update update update update EXECUPDT 
$XEDIT AUXXA AUXXKA AUXXxXxxx 
XEDnnnnn XEDnnnnn $XEDIT Copy fn 
XEDIT XEDIT XEDannan fm 
$XEnnnnn' $XEnnnnn' = XEDIT 
a $XEDIT' $XEDIT* =? 
( a Replace XEDnnnnn XEDnnnan Copy fn 
XEDIT XEDIT XEDIT XEDnannnn fm 
= XEDIT = 


MACLIB Update update update update VMFMAC 
MACRO AUXXA AUXXA AUXXxxxx 
MACnannn' MACnannn' MACRO 
MACRO! MACRO! 


Replace MACLIB 
MACLIB 


COPY Update update update update VMFMAC 
COPY AUXXA AUXXA AUXXXxXxx 
CPYnnnnn' CPYnannn' COPY 
COPY' COPY! 
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Table 23 (Page 2 of 2). Parts Supplied For Service and What to Do with Them 


Usable Form Update or Parts For Parts For Update Parts Build Function 
Replace? COR Service PUT Service | 


MODULE Update | update update update CMSGEND 
ASSEMBLE | TXTnnnnn TXTnnnnn AUXXxxxx UTILITY 
ASManann! ASMnannn' ASSEMBLE GENMOD 
| ASSEMBLE! ASSEMBLE? 
| MODULE! 
Replace text TXTnnnnn TXTnnnnn Copy fn 
deck MODULE TXTnannnn fm 
= TEXT = 
Replace MODazunnnn MODnunnnn 
MODULE MODULE MODULE 
NUCLEUS Update update update update VMFBLD 
ASSEMBLE TXTnnannn TXTnnnnn AUXxxxxx © | HCPLDR 
ASMannnn' ASMannnn' ASSEMBLE 
ASSEMBLE? ASSEMBLE! 
Replace text TXTnnnnn TXTnnnnn VMFBLD 
HCPLDR 
TEXT Update update update update VMFHASM 


ASSEMBLE TXTannnn TXTnnnnn AUXxXxXxxx 
ASMannan' ASMannnn' ASSEMBLE Copy fn 
ASSEMBLE! ASSEMBLE! {| TXTxrannn fm 


= TEXT =? 
Replace text | TXTnnnnn TXTnnnnn Copy jn 
deck 

$PPF Replace $PPF | $PFxnnnn $PFnnnnn 

$PPF $SPPF 


TXTannan fm 
= TEXT = 
Other parts Replace part aaannnnn adaannnnn 
real file type real file type 


Copy fn 
$PFannnn fm 


= $PPF = 


Copy jn 
aaannnnn ft 


= ft = 


nnnnn is the number of the most recently applied PTF. 
XXXXX is one to five alphanumeric characters. 


aaa is the text deck file type prefix from the AUX file identification record in the main control 
file. 


Notes: 


' This is a base part. This part is shipped from IBM only when it is a new part or when the part 
(source) is replaced. 


* This procedure is used when there are no local modifications. 
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Appendix I. How To Find the PTF Number From the APAR 
Number 


If you know the APAR number associated with an update, you can find the corresponding PTF number. 
For example, suppose that you want to find the PTF number for APAR 01010. 


1. Find the file name of a module affected by the APAR. (If you are looking for the PTF number 
associated with an update listed in a DEPEND entry, you already know one.) 


listfile * *01010* * Hf 
HCPABC HOQ1010HP fm 
2. List all text decks with the file name of that module: 
listfile hcpabc txt* * (EXEC @ The EXEC option saves the list in a file called 
CMS EXEC. Any previously existing CMS 
EXEC on your A-disk 1s erased. 


3. Look at each text deck until you find one that lists the APAR you are looking for: 


xedit hcpabc txtnnnnn & 
locate /01010 @ 


HO1010HP COR UMOOQ00 * Comments The APAR number is the five numeric 

* PREREQ: NONE characters in the first word of the text deck 
* CO-REQ: NONE line. The corresponding PTF number is the 
* IF-REQ: NONE third word of the same line. | 


H34567HP COR UMO0001 * Comments 
* PREREQ: NONE 

* CO-REQ: NONE 

* IF-REQ: NONE 

H56789HP COR UMOO002 * Comments 
* PREREQ: NONE 

* CO-REQ: NONE 

* TF-REQ: NONE 

* DEPEND: HO1010HP 

H88888HP COR UMOQO003 * Comments 


(Executable text is here.) 
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Appendix J. Messages 


This appendix contains messages issued by the 
service EXECs. For other messages, see the 
VM/XA SP System Messages and Codes Reference. 


002E [Input|Overlay] {File[(s)||Dataset| 
Note} [fn [ft [/m]]] not found. 


Explanation: The specified file was not found on 
the accessed disk(s). Either the file does not reside 
on this disk, the file identification was misspelled, 
or incomplete identification was provided to cause 
the appropriate disk to be searched, or system disk 
was not accessed as a read-only extension of the 
A-disk. 


For the PRELOAD command, either the 
loadlist EXEC, the CNTRL file, or one of the 
input text files could not be found. 


For SETPRT command, the module 
represented by ‘fn ft’ does not exist in the 
current CMS Disk Search Order. 


For the STATEW command, the file may exist, 
but it is not on any of the user’s read/write 
disks. 


For the ZAP command, either none of the 
libraries specified for a TXTLIB or LOADLIB 
could be found, or the INPUT file name could 
not be located via the STATE macro. 


For the ZAPTEXT and EXPAND commands, 
the input text file or INPUT file name could 
not be located via the ESTATE command. 


For the VMFLKED command, either you 
specified a file that cannot be found on a 
minidisk in the CMS search hierarchy, or you 
specified a file name on a % CONTROL 
statement as the name of a CNTRL file and 
that file was not found. 


For the VMFPLC2 command, the STOP 
option has been specified with the LOAD 
function, and the file was not found in 
alphabetic sequence. 


For the CONVERT command, the input DLCS 
file you specified was not found. 


See the VM/XA SP CMS Command Reference for a 
description of the file identification required by 
each command and the search procedure used. For 


the ASM3705, ZAP, ZAPTEXT, and EXPAND 
commands, see the VM/XA SP Installation and 
Service. 


System Action: RC= 28. 
Execution of the command is terminated. The 
system status remains the same. 


For DMSSPR, nothing has been sent to the virtual 
3800. 


For DMSLIO, some loader information fields have 
been initialized, but they should not interfere with a 
subsequent LOAD command. 


For the CONVERT command, conversion stops. 
RC = 44. 


For the VMFPLC2 command, the tape is 
positioned immediately before the next file. 


For the VMFLKED and VMFZAP commands, 
processing ends. 


For the VMFMERGE command, other required 
files are checked and then processing ends. 


User Response: Find or create the desired file. To 
make sure that the file exists, issue STATE fn ft * 
or LISTFILE fn ft *. Correct and reissue the 
command. 


For DMSSPR, access the disk having the required 
module or respecify a different module 1n the 
calling sequence and then reissue the SETPRT 
command. 


For a DMSROS TEXT file, ensure that the file is 
accessible and reissue the command. 


For the VMFLKED command, make certain that 
the proper disks are accessed and check the name of 
the specified file. If the name was specified 
incorrectly, re-issue the command with the correct 
name. 


For VMFTXT: 


If the file type is EXEC, make sure that a 
memberlist EXEC file exists and that the file name 
of the memberlist and the libname parameter are | 
spelled the same. Correct the error and reissue the 
command. 


If the file type is CNTRL, make sure that the 
specified CNTRL file exists and is correctly spelled. 
Correct the error and reissue the command. 
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If the file name and file type pair is one of the 
following: 


VMFMSGS EXEC 
VMFDATE MODULE 
VMFTXT DATA 


contact your system programmer and arrange to 
have these files installed again on the CMS system 
disk as file mode 2 files. 


For the VMFZAP, VMFMERGE, and 
VMFREMOV commands, see if the proper disks 
are specified in the VMFPARM file and then 
re-issue the command. 


For the CONVERT command, correct the file 
name or access a disk where the file can be found. 


003E Invalid option: option. 


Explanation: The specified option is invalid. It 
may have been misspelled, or, if the option is 
truncatable, it may have been truncated improperly, 
or it may conflict with another option in the 
command line. 


System Action: RC = 24. 


Execution of the command is terminated. The 
system status remains the same. 


For DMSLIO, some option processing may have 
caused such things to happen as user storage to be 
cleared or the location counter to be set. This 
should not interfere with a subsequent LOAD 
command. 


For the VMFLKED command, processing ends. 


User Response: Correct and re-enter the command. 


OSOE Parameter missing after value. 


Explanation: A parameter that is ae by the 
command was not specified. 


For the ASSGN command, the disk mode must be 
specified for the SYSaaa logical unit. 


For the DLBL command, the disk mode or 
DUMMY or CLEAR must be pence after the 
ddname. 


For the FILEDEF command, the device name or 
DUMMY or CLEAR must bee specified after the 
ddname. 


For the NUCXDROP command, a required 
parameter that must follow a function is missing. 
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For the SET command, a required parameter that 
must follow a function is missing. 


For the XMITMSG command, one of the options 
required a value to follow it, but the end of the 
parameter list was reached. 


System Action: RC=24. 


Execution of the command is terminated. The 
system status remains the same. 


User Response: Correct and reissue the command. 


0S56E File fn ft contains invalid 
[name|alias|entry|ESD] record formats. 


Explanation: For DMSLBM and DMSNCP 

(GEN, ADD, REP), the specified file 1s not in the 

expected format. MACRO and MEND cards must oon 
be included in the MACRO files, and the prototype 
card must be specified with a name that does not 
exceed eight characters. If an &COPY statement 
appears, it must contain a name. A MACLIB must 
contain “LIB” in columns 4-6 of record one. 


For DMSLBT, the specified file has more than 255 
entry points (ESD only), or has records which are 
incompatible or missing. The NAME field in the 
CSECT instruction of the specified file must have a piso, 
valid symbol or label. ( \ 


For DMSLIO, an invalid condition was found in a 
TEXT or TEXTLIB file. TXTLIB files created on 
EDF disks must have “PDS” in columns 4-6 of 
record one. TXTLIB files created on non-EDF 
disks must have “LIB” in columns 4-6 of record 
one. RLD data must be compatible with the TEXT 
file or TXTLIB member to which is belongs. If an 
ICS statement was submitted, the specified name 
was previously defined, or the initial length of the . 
CSECT was not found in the ESD card. ee, 


For DMSSYN, the specified file is not in the 
expected format. The SYNONYM file must 
contain 80-byte records in free form format, with 
columns 73-80 ignored. The data consists of a 
command name followed by a blank and the user 
synonym. This may optionally be followed by a 
count which is preceded by at least one blank. 


For DMSZAP, either the header record for 
TXTLIB or LOADLIB was invalid, or the pointer 
to the directory or module map was in error. 


For the VMFTXT command, the memberlist 
EXEC file was not in the required format. 


System Action: RC =32. 


\ 


Execution of the command is terminated. The 
system status remains the same. For DMSGLB, 
the library is not globally searched, and the 
operation continues for any other libraries named in 
the command. 


For the VMFTXT command, the invalid record is 
ignored. Processing continues for any remaining 
records in the file. 


User Response: For DMSLBM and DMSNCP, 
issue the MACLIB COMP command, then check 
the MACLIB with a MACLIB MAP command. 
Correct the format error. 


For DMSGLB, the specified library does not have 
“LIB” in columns 1-3 or 4-6 of the first record. 
One possible cause is the library may be in packed 
format. Correct the library and reissue the 
command. 


For DMSSYN, correct the format of the file. 
For DMSLIO, recreate the TXTLIB or TEXT file. 


For DMSLBT, if the message specifies ESD, check 
for more than 255 entry points for a member; 
otherwise, check for invalid or missing records. If 
the NAME field in the CSECT instruction was left 
blank, enter a valid symbol or label. 


For the VMFTXT command, correct the invalid 
entry in the memberlist EXEC file. If the member 
specified in the invalid record has a file type of 
TEXT, you may issue the: 


TXTLIB VMFTXT ADD membername 
<(FILename<)>> 

RENAME VMFTXT TXTLIB A libname 
TXTLIB A 


commands. If the file type is not TEXT, then erase 
VMFTXT TXTLIB A and then reissue the 
command. 


For DMSZAP, recreate the library or module. 


Then reissue the command. 


06S5E option option specified twice. 


Explanation: The option was specified more than 
once in the command line. 


System Action: RC=24. 


Execution of the command is terminated. The 
system status remains the same. 


User Response: Reissue the command, specifying 
the option only once. 


1801E There is no tape mounted on 181. 
Mount the correct tape and restart the 
receive procedure. 


Explanation: VMFREC expects a tape to be 
mounted on 181, and there was no tape mounted. 


System Action: VMFREC exits with RC = 100. 


User Response: Mount the tape to be received and 
restart VMFREC. 


1802R The tape mounted is at a lower service 
level than the existing service map. 
The service tape is at service level /eve/ 
The SERVICE DISKMAP file indicates 
service level service-level 
Is this what you want? (YES/NO) 


Explanation: VMFREC will receive data from a 
PUT that is at a lower level than was previously 
received. 


System Action: If the response to the prompt Is 
NO, then VMFREC exits. Otherwise, the receive 
procedure continues. 


User Response: Respond to the prompt by entering 
either YES or NO. 


1803E The tape is in the wrong format. 
Mount the correct tape and restart the 
receive procedure. 


Explanation: VMFREC expects the first tape file 
to contain a file that determines the tape type. This 
file 1s either incorrect, or is not present. 


System Action: VMFREC exits with RC = 100. 


User Response: Mount the correct tape. 


18041 Receiving service for {product 
prodid|component compname of product 
prodid}. 


Explanation: This is an informational message 
indicating which product service is being received 
for. 


System Action: VMFREC continues receiving 
service. 


User Response: None. 
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1805E No|Not enough parameters were entered. 
Check the syntax and re-enter the 
command. 


Explanation: An attempt was made to execute a 
procedure, but the required parameters were not 
entered. 


System Action: The procedure exits with RC = 8. 


User Response: Review the documentation and 
restart the procedure with correct parameters. 


1806I The current SERVICE DISKMAP file 
contains the map of the mounted tape. 


Explanation: This is an informational message, 
indicating that the tape currently mounted has been 
previously mapped. 


System Action: VMFREC continues receivin 
Service. 


User Response: None. 


1807E routine cannot continue; the fn ft file was 
not found. 


Explanation: A procedure requires a file that 
cannot be found on an accessed minidisk. 


System Action: The procedure exits with RC = 28. 


User Response: The file named in the message 
needs to be made available. Verify that the 
muinidisk access is as it should be. Check the 
product parameter file to verify that the correct 
minidisk is listed in the component minidisk 
assignment (MDA) section. 


1808E The ppfname $PPF product parameter 
file was not found. 


Explanation: A procedure requires a product 
parameter file in order to set required parameters, 
and the file cannot be found on an accessed 
minidisk. 


System Action: The procedure exits with RC = 28. 


User Response: The file named in the message 
needs to be made available. Verify that the 
minidisk accesses are as they should be. 
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1809E — ‘A function tape error has occurred with 
return code rc. 


Explanation: VMFREC has encountered a serious 
tape error. 


System Action: The procedure exits with the return 
code received from the VMFPLC2 command. 


User Response: Correct the tape drive problem as 
indicated by rc from the VMFPLC2 command. If 
drive is fine then the tape might not be in the 
correct format for the procedure. 


1810R Enter a component name or type QUIT. 


Explanation: The procedure needs a component 
name in order to carry out its function. 


System Action: The procedure waits for a valid 


™m ™M ha antarad ar OATITITT 
component name to oe entered or Qui. 


User Response: Enter a component name listed in 
the product parameter file for the product 
requested. 


1811W The access of vdev failed for product 
prodid: 


Explanation: An access command has failed for the 
minidisk listed in the message text. 


System Action: The procedure exits with RC = 4. 


User Response: Verify that the minidisk is linked 
correctly. 


1812E Service for prodid is not on the mounted 
tape but the prodid product ID is in the 
SERVICE DISKMAP file. It is on the 
service tape mapped with a relative tape 
number of number. 


Explanation: The wrong tape volume is mounted 
on tape 181. 


System Action: The procedure exits with RC = 28. 


User Response: Mount the correct tape volume 
and restart the procedure. : 


1813E option! and option2 are conflicting 
options. Check the syntax and re-enter 
the command. 


Explanation: Conflicting options have been 
entered. 


System Action: The procedure exits with RC = 8. 


User Response: Check the documentation, then 
restart the procedure using correct command 
syntax. 


1814E Service for the product ID prodid is on 
the mounted tape, but the prodid product 
ID is not in the SERVICE DISKMAP 
file. 


Explanation: The tape has not been mapped 
correctly. 


System Action: VMFREC exits with RC = 28. 


User Response: Erase the existing service map and 
restart VMFREC. 


1815E parameter is an unknown parameter. 
Check the syntax and re-enter the 
command. 


Explanation: An unknown parameter was detected 
by the procedure. 


System Action: The procedure exits with RC = 8. 


User Response: Check the documentation, then 
restart the procedure using correct command 
syntax. 


1816E parameter is an unknown parameter. 
This product ID is not on the tape or in 
the SERVICE DISKMAP file. 


Explanation: The first or only parameter entered is 
invalid. 


System Action: The procedure exits with RC = 8. 


User Response: Check that the product ID that 
was entered is valid. 


18S17E The updateid-name update ID is not in 
the fn CNTRL file. 


Explanation: The update ID entered on the 
command line, or listed in the product parameter 
file, was not found in the control file listed in the 
product parameter file. 


System Action: The procedure exits with RC = 28. 


User Response: Verify that the correct update ID 
was entered, either on the command line or in the 
product parameter file, according to the procedure 
syntax. Check that the correct control file is listed 
in the component section of the product parameter 
file. 


1818E The product service header file cannot be 
found. 
The tape positioning might be in error. 
Restart the receive procedure beginning 
with service for product ID prodid. 


Explanation: VMFREC cannot find the product 
header file on the tape, in the tape file calculated. 


System Action: VMFREC exits with RC = 28. 


User Response: The tape positioning might be 
incorrect upon return from an unsupported product 
service EXEC. If this is thought to be the case, 
then restart the procedure, starting with the product 
listed in the message text. If this is not the case, 
then the file counts in the component list of the 
product parameter file might be incorrect. 


1819E The control file fn ft was not found. 


Explanation: The control file listed in the 
component section of the product parameter file 
cannot be found. 
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System Action: The procedure exits with RC = 28. 


User Response: Verify that the control file listed is 
correct, and that the minidisks are accessed 
correctly. 


1820E The build list fn ft was not found. 


Explanation: The build list listed in the component 
section of the product parameter file cannot be 
found. 


System Action: The procedure exits with RC = 28. 


User Response: Verify that the build list listed is 
correct and that the minidisks are accessed 
correctly. 


SS Oe _—a Santee aiinaentied m aay 


previous access order will be restored. 


1821E All file modes are heing nced Tha 


Explanation: Access to required minidisks failed 
because no file modes were available. 


System Action: The procedure exits with RC = 
100. 


User Response: Release unwanted minidisks. 
Reduce the number of minidisks listed, as required 
in the component section of the product parameter 
file. 


1822W Access to vdev cannot be restored. 


Explanation: Upon exit, the procedure could not 
reaccess the minidisk listed. 


System Action: The procedure continues with RC 
= 4, 


User Response: Upon exit, reaccess the minidisk if 
needed. 


1823W The fn ft PTF parts list file was not 
found. A PTF might be missing for 


product ID prodid. 


Explanation: A file listed in a PTF parts list could 
not be found. | 


System Action: The procedure continues with RC 
= 4. 


User Response: Investigate why the PTF part is 
missing. Check the minidisk assignments (MDA) 
section for the component in the product parameter 
file. 
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1824E vdev, accessed as fm, is not R/W. 


Explanation: The procedure requires the minidisk 
listed in the message text to be read/write. © 


System Action: The procedure exits with RC = 
100. | 


User Response: Reaccess the minidisk as 
read/write, and restart the procedure. 


1825W A part handler cannot be found for part 
part-type while applying PTF ptfnum to 


product ID prodid. 


Explanation: A part is listed in the component 
section of the product parameter file with a part 
handler EXEC that cannot be found on an accessed 
minidisk. 

System Action: The procedure continues with RC 
= 4. 


User Response: If this was a part that was 
intentionally bypassed, then no action is required. 
Otherwise, find the part listed in the component 
section of the product parameter file and verify the 
listed part handler spelling. Check the minidisk 
accesses for correctness. 


1826W The part type fn ft was not found while 


executing the xame part handler. 


Explanation: A part listed in the component 
section of the product parameter file cannot be 
found on an accessed minidisk. 


System Action: The procedure continues with RC 
= 4, 


User Response: Find the part listed in the 
component section of the product parameter file 
and verify that the part is spelled correctly. Verify 
the minidisks are accessed correctly. 


1827S The name part handler failed for part fn 
ft while applying PTF ptfnum for product 
ID prodid. 


Explanation: The part handler listed in the 
message text failed. 


System Action: The procedure exits with RC = 
100. | 


User Response: Determine the cause of the part 
handler failure by examining its error messages. 


1828W The prefix xxx is listed in the control file 


fn, but a PTF number cannot be found. 


Explanation: A prefix (xxx) has been listed on a 
control file level indicating that the text deck will be 
named by a PTF number, but an auxiliary control 
file containing a valid PTF number cannot be 
found. 


System Action: RC=4. 
Text deck is named according to the control file 
without the use of a PTF number. 


User Response: Check the control file and auxiliary 
control structure. 


1829W 


Explanation: The VMFAPTXT part handler failed 
while attempting to apply the update listed in the 
message text. 


The fn ft update cannot be applied. 


System Action: The procedure continues with RC 
= 4. 


User Response: Examine previous messages to 
determine the cause. 


1830E label has been specified as the target for 
the component compname of product 
prodid. There is no target listed on the 


label tag. 


Explanation: A symbolic string has been specified 
as a target, but the label in the minidisk 
assignments (MDA) section of the 56643082 $PPF 
file does not contain any minidisk address. 


System Action: The procedure exits with RC = 
100. 


User Response: Correct the MDA section in the 
file and reinvoke the procedure. 


1831W PTF pt/num is included in fn ft. It is in 
the exclude list fn ft, but cannot be 


excluded. 


Explanation: The PTF specified in the SEXCLIST 
is contained in a part of the PTF being applied. 
VMFAPPLY can only exclude PTFs serially from a 
text deck (the last PTF applied). 


System Action: The procedure continues with RC 
= 0. 


User Response: Refer to VM/XA SP Installation 
and Service for instruction on how to process PTFs 
that could not be excluded by VMFAPPLY. 


| 
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1832W Text deck fn ft is included in the name 


build list but cannot be found. 


Explanation: A text deck, listed in the build list to 
be included in the build, cannot be found on an 
accessed minidisk. 


System Action: The procedure continues with RC 
= 4. 


User Response: Check that the correct minidisks 
are listed in the component section of the product 
parameter file. Verify that this deck was 
intentionally removed from the access order. 


1833W Text deck fn ft does not contain any 
executable code but is listed in the name 
build list. The build process might not be 


complete. 


Explanation: A text shell (a text deck that contains 
only requisite information) has been found. It 1s 
listed in the prologue of another text deck as an 
update. 


System Action: The procedure continues with RC 
= 4. 


User Response: Investigate why this text deck is 
missing. 


1834W The file type of fn ft might be incorrect 


due to preferred AUX files. 


Explanation: The file type of a text deck was 
found on a level of the control file that also 
contains preferred files. 


System Action: The procedure continues with RC 
= 4. 


User Response: Check the control file named in the 
component section of the product parameter file for 
correctness. 


1835E AUX file fn auxft on vdey could not be 
saved by XEDIT when adding update fn 
update-ft. PTE(s) included in fn might 


be partially applied. 


Explanation: VMFAPPLY could not completely 
process all the changes included in the text deck 
that is a part of the PTF being applied. 


System Action: The procedure exits with RC = 
100. 
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User Response: Add another APPLY minidisk to 
the $PPF file or increase the size of the current 
APPLY minidisk and restart VMFAPPLY.. 


1836E This program requires file mode A to be 
accessed as R/W. 


[Access mode A as R/W and re-try. ] 


Explanation: The procedure cannot continue 
without a read/write file mode A. 


System Action: The procedure exits with RC = 
100. 


User Response: Access a read/write file mode A 
and restart the procedure. 


1837W fn ft fm update entries do not match the 
control file for update fn ft. 


Explanation: While checking the entries in the text 
deck with the AUX entries in the AUX file and 
update entries in the control file, a mismatch has 
been detected. 


System Action: The procedure continues with RC 
= 4. 


User Response: Investigate the problem with 
textdecks not matching the AUX file and control 
file. 


1838E The service exec requires file mode C to 
be accessed as R/W. Access mode C as 


R/W and re-try. 


Explanation: For a product with its own service 
EXEC, a read/write file mode C must be accessed. 


System Action: The procedure exits with RC = 
100. 


User Response: Access a read/write file mode C 
and either copy the existing SERVICE DISKMAP 
for file mode A to file mode C, or erase any on file 
mode A before reinvoking VMFREC. 


1839W Multiple update files for product ID 


prodid have been found on: ydev 


Explanation: Duplicate update files exist on 
different minidisks for the same product. 


System Action: The procedure continues with RC 
= 4. 
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can be picked up at build time. 


User Response: Be aware that, with multiple 
updates, there is a possibility that the wrong decks 


The AUX file entries in fn/ ft] fm/ and 
fn2 ft2 fm2 do not match. 


1840W | 


or 


jn ft fm contains AUX entries but an 
AUX file has not been located. 


Explanation: While comparing AUX entries 
between the given text deck and AUX file or 
between the two given AUX files, a mismatch has 
been detected. The PTF that was being processed 
when the error was detected may be partially 


applied. | oo 
System Action: The procedure continues with RC Se 
= 4. 


User Response: Investigate the reason for the 
mismatch, correct it, and retry the procedure. 


1841W The fn ft update file was not found. 


An update shell has been created. 


Explanation: An update file pointed to by an entry U 
in a text deck prologue or an AUX file could not : 
be found on an accessed minidisk. Update shells 

are only created for text decks. When the update 

file is for another type of part (for example a 

MACRO or an EXEC), the second part of this 

message is not issued and no update shell is created. 


System Action: The procedure continues with RC 
= 4, 


User Response: Investigate why the update file \ 
listed in the message text was not found. 


1842W The fn ft file was not found. 
The exclude option was ON but there is 
no exclude list. The process is continuing 


with the exclude option set OFF. 


Explanation: VMFAPPLY cannot locate the 
SEXCLIST file for the control file specified in the 
product parameter file. 


System Action: The procedure continues with RC 
= 4, 


User Response: Investigate why the $EXCLIST file 
listed in the message text was not found. 


1843 W The fn ft update cannot be applied for 


PTF ptfname. vdev must be R/W. 


Explanation: The update files are marked 
“applied” by renaming from file mode number | to 
5. The disk that the files reside on must be 
read/write in order to rename. 


System Action: The procedure continues with RC 
= 4, 


User Response: If the update file should have been 
applied, then move the file to a read/write minidisk 
and restart the procedure. 


1844W For product prodid, PTF ptfnum part fn 


ft was not found. 


Explanation: A part listed in a PTF part list could 
not be found. 


System Action: The procedure continues with RC 
= 4. 


User Response: Investigate why the part was not 
found. 


1845W _—ss fn ft file is a text deck shell for PTF 
ptfnum. 


Explanation: A text deck that is listed as a part of 
the PTF listed in the message text could not be 
found. 


System Action: The procedure continues with RC 
= 0. 


User Response: Investigate why the deck was not 
found. 


1846W Update file fn ft has a requisite of 
ptfnum. The update file for part 
part-type cannot be found on a R/W 
disk. The DEPEND entry cannot be 


entered. 


Explanation: A text deck contains a requisite that 
points to an update file that cannot be found, or a 
depend entry cannot be written because the update 
file is on a R/O disk. The depend function is 
bypassed. 


System Action: The procedure continues with RC 
= 4, 


User Response: Investigate why the requisite 
update file was not found. 


1847W ptfnum] is referenced in update file fn ft 
and is a part of PTF pifnum2. ptfnum!1 


is a requisite for another component. 


Explanation: This is a warning message, indicating 
that a requisite exists that is outside of the 
component. 


System Action: The procedure continues with RC 
= 0. 


User Response: None. 


1848E jn ptf-ft on vdev could not be 
copied/renamed to base-ft on vdev. AUX 
files and update files show all service in 


text deck fn ptf-ft has been applied. 


Explanation: VMFAPPLY could not complete 
processing a text deck that is part of the PTF. The 
text deck being processed needs to be renamed to 
its base file type, and copied to the minidisk 
identified in the message. This text deck is not 
supported by VMFBLD. 


System Action: The procedure exits with RC = 
100. 


User Response: Copy and rename the text deck 
identified in the message to another minidisk listed 
for the component in the $PPF file, or increase the 
size of the current DELTA minidisk and 
copy/rename the text deck. 


APAR aparnum is a requisite of APAR 
aparnum and the aux entry update-file 
type is not included in the self 
documenting prolog information of the 
text deck file name file type. 


or 


APAR aparnum is a required requisite, 
but part file name file type on disk 
address has not been applied by 
VMFAPPLY and the update file is not 
fm5. 


Explanation: First message: An update file was 
found for the text deck listed in the message and 
this update file was not included in the self 
documenting prolog information of that text deck. 


Second message: An update file was found for the 
APAR listed in the message and this update file was 
not applied by VMFAPPLY. 


System Action: The procedure continues with RC 
= 4, 
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User Response: First message: Investigate why the 
aux entry identified in the message is missing from 
the updated text deck. The text deck may have 
been built without a requisite APAR. 


If this text deck was built by IBM, this text cock 1S 
in error. Report this to your IBM service 
representative. 


If the text deck was built sea you may have left 
out a required entry in an aux file for the text deck 
identified in the message. Correct the aux file and 
run VMFBLD again. 


Second message: Investigate why this update file 
has not been applied. 


1850] The processing for part-name by the fn 
EXEC was bypassed. 


Explanation: Processing of a part has been 
bypassed. This could occur if the part handler has 
been commented out in the product parameter file. 


System Action: The procedure continues. 


User Response: If the part was expected to be 
handled, investigate why the part handler EXEC 
was not found. 


18511 Processing fn ft with the part handler 
parthandler EXEC. 


Explanation: This is an informational message 
indicating that the function requested is progressing 
to the next part. 


System Action: The procedure continues. 


User Response: None. 


18521 This is volume-number of total-volumes, 
level /evel {PUT|COR} tape. 


Explanation: This is an informational message 
indicating the level of the tape being processed. 


System Action: The procedure continues. 


User Response: If the tape level is correct, no 
response is necessary. Otherwise, stop the 
procedure, mount the correct tape, and restart the 
procedure. 
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18531 Processing PTF ptfnum. | 


Explanation: This is an informational message 
indicating that the function requested is progressing 
to the next PTF listed in the PTF parts file. 


System Action: The procedure continues. 


User Response: None. 


1854W ptfnum is a requisite for another 


component. 


Explanation: This message indicates that a PTF 
has been found that lists a requisite that is not a 
part of the component being processed. 


System Action: The procedure continues with RC 
= 4, 


User Resnanse: Verify that the out-of-componcnt 


rome ee y 


requisite will be applied. 


~ Control file jn contains invalid data. 
Text deck fn will not be named by PTF 
number. 


1855W 


Explanation: A record was found in the control file 
that violates the control file rules as defined in 
VM/XA SP CMS Command Reference under the 
UPDATE command. 


System Action: RC=4. 
The text deck is named according to the control file 
without the use of a PTF number. 


User Response: Check the control file and AUX 
structure for invalid level [Ds or update identifiers. 


18561 PTF ptfnum is in the fn ft exclude list for 
product ID prodid , and will not be 
applied. 


Explanation: This is an informational message 
indicating that a PTF listed in the apply list will not 
get applied, because it is also listed in the exclude 
list. 


System Action: The procedure continues. 


User Response: None. 


1857] APAR aparnum is a required requisite, 
but part fn/ ft] on disk disk address has 
not been applied by VMFAPPLY and 
the update file is not fm5. 


Explanation: A textdeck includes a requisite which 
has an update that has not been applied as 
indicated by a file mode other than fml. 


System Action: The procedure continues with 
return code 0. 


User Response: The message is informational. The 
part identified in the message text is a part that 
must be processed manually. VMFAPPLY changes 
the file mode of update files for TEXT decks to a 5 
when processed. Update files for other parts, such 
as EXECs, XEDIT macros, MACROs and COPY 
files, will force this message to be issued since file 
modes on update files for these parts are 1 
(VMFAPPLY doesn’t process these update files). 
The message can be eliminated by changing the file 
mode on update files for these other parts to a 5. 
Next time VMFAPPLY is run (you don’t have to 
run VMFAPPLY again now), these messages will 
not be issued. | 


18581 message 


Explanation: The variations of this message are 
explained below. 


System Action: In each case, the procedure 
continues. 


User Response: In each case, refer to VM/XA SP 
Service Guide for instructions on how to regenerate 
service parts of the system. 


Messages: 


e fn build list contains files that have been 
serviced. 


Explanation: VMFAPPLY has processed a PTF 
that contained a new level of a file contained in 
the build list found in the build (BLD) section 
of the product parameter file). VMFBLD 
should be invoked to regenerate the object 
associated with the build list, such as the 
nucleus and the module. 


e fn ft has been serviced. 


Explanation: VMFAPPLY has processed a PTF 
that contained a new level of the file identified 


in the message. A build step might be required 
to make the change available for execution. 


1859] The name build exec completed with 
return code rc. 


Explanation: The part handler identified has 
completed the build step required for a build list 
specified in the product parameter file. 


System Action: The procedure continues, with 
return code set to re. 


User Response: None. 


1860E compname is an invalid component name 
for product ID prodid. 


Explanation: The base compname listed on the 
override compname tag was not found in the 
complist tag. 


System Action: The procedure exits with RC = 
100. 


User Response: Verify that the override and 
complist tags match. If not, change the tag that 1s 
incorrect. 


18601 compname is an invalid component name 
for product ID prodid. 


Explanation: A component name has been entered 
for a product that does not contain that 
component. 


System Action: The procedure continues and 
prompts you for a valid compname. 


User Response: Respond to the prompt by entering 
a valid compname. 


1861W The /n service exec completed with return 


code rc message. 


Explanation: The service EXEC has completed the 
task. The return code (rc) indicates whether the 
exec was successful or not at completing the task. 
message may be one of the following according to 
the return code (rc) specified: 


e rc = 0 
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The service has been received. 


VMFREC has invoked a product service 
EXEC, and the EXEC has completed 
successfully. 


e 0<re>4 


Service received, might have been done 
previously. 


VMFREC has invoked a product service 
EXEC, and the EXEC has completed 
successfully. Service for this EXEC may have 
already been received before. 


e 3<rc>8 
Service received, a build might be required. 


VMFREC has invoked a product service 
EXEC, and the EXEC has completed 
successfully. The product for which service was 
received may need to be rebuilt in order to 
apply the service. 


User Response: Review service procedures for 
the product service to check if a build is 
required. 


e 7<re>12 


Receive has been discontinued, some service may 
have been received. 


VMFREC has invoked a product service EXEC 
and the EXEC was halted before service was 
completely received. 


User Response: Correct the problem that 
caused the product service EXEC to fail and 
restart VMFREC. 


e re>Ii 


Receive has been discontinued, tape position 
unknown. | 


VMFREC has invoked a product service EXEC 
and the EXEC has been halted at an unknown 
point in the process. 


User Response: Correct the problem that 
caused the product service EXEC to fail and 
restart VMFREC. 


System Action: VMFREC exits with rc unless the 
list option was specified, in which case the next 
product in the list is processed. 


User Response: None, unless otherwise indicated 
above. 
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18621 The LTO option was specified, but not | 
all targets are accessed R/W as required. 
The LTO option has been set OFF. 


Explanation: In order to specify the last-text-only 
option, the target minidisks must be accessed as 
read/write. 


System Action: The procedure continues with the 
last-text-only option turned off. 


User Response: If the last-text-only option is 
desired, stop the procedure and reaccess the target 
minidisks in write mode, then restart the procedure. 


1863W Service has been received on the S 
minidisk. Module generation and/or 
reIPL of CMS might be required. 


Explanation: Service has been received onto the 
system minidisk. 


System Action: RC=4. 


User Response: The system minidisk needs to be 
re-IPLed, or the CMS segment might need to be 
resaved. 


1864E Service exec previously failed for prodid 
compname! on PUT level] 
You must rerun service-exec for prodid 
compname!l on PUT levell before 
running service-exec for prodid 
compname2 on PUT level2 


Explanation: More than one $ER® erase list has 
been found in the access order. Update files from 
the level 1 PUT were not processed completely. 


The variables in the message text are defined as 
follows: 


The main EXEC name (VMFREC) 


Service-exec 


prodid The product ID 

compname | The previously failing component 
ID 

levell The failing PUT level 

compname2 The current component ID 

level2 The current PUT level 


System Action: RC=23 (for merge error). 
The function is terminated. 


User Response: The function cannot be reinvoked 
until one of the duplicate $ER* erase lists is 
removed from the access order. The component 


a 


WY 


identified in the message text should be run after 
the duplicate file is removed. 


1865W Update files for prodid compname have 
been found on the target. The target 
should be empty. The MERGE tag 
parameter in the $PPF file might be 


improperly specified. 


Explanation: The target minidisk should be empty 
at the start of receive for update files. If the target 
muinidisk is listed on the MERGE tag in the PPF 
correctly, the minidisk should be empty. 


System Action: RC =4. 
A prompt allows the user to continue with the 
process or discontinue receive. 


User Response: Unless the intent is to receive 
updates to a minidisk that has already received 
updates, the user should exit and check the PPF for 
correct string labels on the MERGE tag. 


1866W Duplicate update files have been found in 
the target and APPLY access orders. 
Merge might not have been done 


correctly. 


Explanation: Duplicate update files have been 
found on the target and APPLY minidisk strings. 


System Action: Update file processing continues 
with RC = 4. 


User Response: With the proper use of the service 
tools and MERGE tag in the PPF, this situation 
should not occur. Manual file manipulation is 
necessary in order to remove the duplicate files. 


1867E The loadlist loadlist name EXEC 
[vdev|dirname | does not contain a valid 


loader name. 


Explanation: The loader invoked for the build of 
the component being processed is determined by the 
loader card specified in the loadlist identified in the 
‘BLD. section of that component in the product 
parameter file. This loadlist does not contain a 
loader card that is recognized by the EXEC as a 
valid loader. 


System Action: The procedure exits with RC = 
100. 


User Response: Examine the loadlist for a loader 
card. If one does not exist then add one. If one 
does exist then it is not supported by the 
parthandler invoked to process it. Modify the 
product parameter file to invoke a parthandler that 
does support the format of this loadlist. 


1868W AUXFILE fn ft contains PTF# 
pt{fnumber but textdeck fn ft could not be 
located. Search will continue with the 


level ID from the control file. 
or 


The control file fn CNTRL indicates that 
part fn2 ft2 should exist but it can not be 
located. Searching will continue at the 
next level. 


Explanation: 


First message: In determining the file type of a 
textdeck using the AUX and control file structure, 
an AUXFILE has been found that contains a valid 
PTF or local tracking number. A textdeck file type 
formed with this number and prefix cannot be 
located using the current access order. This may 
result in a build being done with a lower level 
textdeck. 


Second message: In determining the file type of a 
textdeck using the AUX and control file structure, 
an update or AUX file was specified in the control 
file, and the update or AUX file exists on an 
accessed disk but a part with a file type of the 
prefix concatenated with the LEVELID could not 
be located. 


This condition may also exist if the update specified 
in the control file contains a prefix but the next 
AUX level points to an AUXFILE that does not 
contain a valid PTF number. In this case, a search 
is made using the LEVELID from the control file 
which may cause the message to be issued as 
described above. 


System Action: In each case, the procedure will 
continue to process the control file searching for a 
textdeck file type. RC is set to 4. 


User Response: In each case, investigate the access 
order to determine if the textdeck identified in the 
message can be located. If it can be located, either 
the disk should be added in the PPF, or the 
textdeck copied to a disk that is listed in the PPF. 
If the deck cannot be located, then the module 
should be re-assembled. 
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1869R prodid compname begins on PUT|COR 
tapenum volume vol. Mount volume vo/ 
and press ENTER or type QUIT. 


Explanation: The service you are receiving for a 
product/component begins on another tape. 


System Action: The procedure continues when you 
press ENTER, or exits if you type QUIT. 


User Response: Mount the tape containing the 
service for the component and press ENTER. 
Alternatively, type QUIT, mount the next tape and 
remvoke VMFREC to load the rest of the service 
for the component. 


1870R Choose the component which is to be 
processed from the list below: 


Exolanation: A procedure has been requesied, but 
a component name was not specified. The names 
displayed are taken from the COMPLST and 
OVERLSTP tags in the product parameter file. 


System Action: The system waits for a response to 
the prompt. 


User Response: Enter a component name from the 
list displayed, or enter QUIT. 


1871R Do you want to continue: (YES/NO). 


Explanation: An opportunity is given to 
prematurely exit the procedure. 


System Action: The system waits for a response to 
the prompt. 


User Response: Answer the prompt. 


1872E COR Is 2 nonsupported option for the 
prodid product ID. The tape has been 
positioned to the beginning of the 
product's first file. Use the product’s 
corrective service procedure to process. 


Explanation: The product specified on the 
VMFREC command is not packaged in the format 
required by VMFREC. Refer to the product’s 
documentation for the procedure to follow for 
corrective service. 


System Action: The procedure exits with RC = 8. 
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User Response: None. 


1873W | prodid compname relative tape file 
number, label is listed in the product 
directory but is not in the $PPF file. 


This tape file will not be received. 


Explanation: The product specified on the 
VMFREC command is not packaged in the format 
required by VMFREC. Refer to the product’s 
documentation for the procedure to follow for 
corrective service. 


System Action: The procedure continues with RC 
= 4. 


User Response: Correct the receive service 
(RECSER) section in the $PPF file for the 
component snecified on the VMFREC command. 
Add the label and part handler for the tape file. 


1874R The execname option PUT|COR does not 
match the type of the mounted tape 
PUT|COR. Do you want to continue? 
(YES/NO) 


Explanation: VMFREC is receiving service from a 
preventive or corrective tape, but the option 
specified on the command does not match the tape 


type. 


System Action: The procedure exits if response 1s 
NO, continues if response is YES. 


User Response: Enter YES or NO. 


1875E XEDIT cannot save file fn ft on disk fm. 
The return code from XEDIT was rc. 
Correct the problem and re-start the 
procedure from the beginning. 


Explanation: The procedure being run could not 
save the file being edited. The minidisk might be 
full. 


System Action: The procedure exits with RC = 
100. 


User Response: Look up the return code from 
XEDIT and determine the cause of failure. Correct 
the problem and restart the procedure from the 
beginning. 


waren 


1876E The VMFAPPLY option PUT|COR does 


not match the apply list specified. 


Explanation: VMFAPPLY was invoked with the 
PUT or COR option, but the $APPLIST being used 
does not match the option specified. 


System Action: The procedure exits with RC = 
100. 


User Response: Reinvoke VMFAPPLY, using the 
correct option. 


1877R prodid compname begins on PUT|COR 
tapenum volume vol. Do you want to 


continue? (YES/NO) 


Explanation: VMFREC is receiving service for a 
component that started on a previous tape. You 
should not receive this service if you have not 
already received the service from the other tape. 


System Action: The procedure exits if response is 
NO, continues if response is YES. 


User Response: Enter YES or NO. 


18781 No files have been found for prodid 
compname on the PUT|COR level level. 


Explanation: VMFREC could not find any service 
for the product/component on the tape that is 
currently mounted. 


System Action: The procedure continues with RC 
= 0. 


User Response: Check other tape volumes for this 
service level for the product/component. 


1879R product-name component-name on 
PUT\COR level-number volume 
vol-number continues on volume 
vol-number2. Mount volume vol-number2 


and press ENTER or type QUIT. 


Explanation: The service you are receiving for a 
product/component is continued on another tape. 


System Action: The procedure continues when you 
press ENTER, or exits if you type QUIT. 


User Response: Mount the tape containing the 
remainder of the service for the component and 
press ENTER. Alternatively, type QUIT, mount 
the next tape and reinvoke VMFREC to load the 
rest of the service for the component. 


| 
| 
| 
| 
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1880W fn ft is an update file that has a requisite 
for APAR aparnum, but no update file 
can be found. 


Explanation: VMFAPPLY found a requisite 
APAR for the update being applied, and could not 
locate an update file that contained the APAR 
number in the file type. The file type of the update 
file being applied could not be added to the 
DEPEND tag for this update. 


System Action: The procedure continues with RC 
= 4, 


User Response: Locate the update file(s) for the 
APAR, and add the file type specified in the 
message to the DEPEND tag. The situation where 
no update files can be found is not an error 
condition if the PTF that corresponds to the given 


ft does not contain any parts that are serviced with 


update files. 


1881W Text deck fn ft on vdev contains an 
applied update, but the AUX file cannot 
be found on the APPLY string. The 


PTF was not applied. 


Explanation: The text deck being processed 
contains an update that has a file mode number of 
5, which indicates it has been added to an AUX 
file. VMFAPPLY could not find an AUX file on 
any minidisk listed on the APPLY tag in the $PPF 
file. 


System Action: The procedure continues with RC 
= 28. 


User Response: Change the file mode number of 
the update file to a 1 and retnvoke VMFAPPLY, or 
create an AUX file for the text deck on a minidisk 
listed in the APPLY string, and add the update file. 


1882W AUX file fn ft on vdev is inconsistent 
with the text deck fn ft on vdev. The 


PTF was not applied. 


Explanation: The text deck being processed 
contains an update that has been applied, but it is 
not contained as the first entry in any AUX file 
found in the APPLY string. VMFAPPLY cannot 
determine where the update being applied should be 
added to the AUX file. 


System Action: The procedure continues with RC 
= 4. 


User Response: Change the file mode number of 
the update file to a 1 and reinvoke VMFAPPLY, or 
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add the update to an AUX file for the text deck on 
a minidisk listed in the APPLY string. 


1883W There was a problem loading the apply 


and exclude lists. 


Explanation: VMFREC was not able to 
copy/rename the apply and exclude contained on 
the service tape to the target minidisk. The 
minidisk might be full, or an incorrect level of the 
apply or exclude list might have been shipped on 
the tape. 


System Action: The procedure continues with RC 
= 28. 


User Response: Check the target minidisk for the 
correct level of the apply and exclude list. If found, 
then copy/rename them to $APPLIST and 
$EXCLIST. If they are not found, contact your 
IBM support center. 


1884W ptfnum is an included|dependent PTF in 
fnl ftl. It has been added to fn2 ft2 


apply list. 
or 


ptfnum is a dependent PTF in fn ft. It 
has been added to the control-file name 
SAPPINCL apply list. 


Explanation: While applying a PTF, a text deck or 
AUX file was processed that contained additional 
PTFs that were not in the $APPLIST. 
VMFAPPLY will process these PTFs as if they 
were in the $APPLIST, to ensure that all service 
required for the PTF is applied. 


System Action: The procedure continues with RC 
= 0. 


User Response: None. 


1885W Jnl ft listed in fn2 CNTRL represents 
service at a higher level than fn3 13. 
The higher-level service may need to be 
reworked or removed. 


Explanation. VMFAPPLY found an AUX file or 
update file at a higher level in the control file than 
the AUX file being updated by VMFAPPLY. If 
the file found is an AUX file, its contents follow the 
message. 


System Action: The procedure continues, with RC 
= 0. 
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User Response: The higher-level service must be 
investigated to determine if it conflicts with the new 
service in the AUX file being updated by 
VMFAPPLY. Any service that is duplicated by the 
new service must be removed from the higher level. 
Any service that conflicts with the new service must 
be reworked so that it no longer conflicts. 


1886W Update file fn ft on addr has a file mode 
other than fm5 but auxfile fn ft on addr 
contains an AUX entry for this update. 
The PTF was not applied because of this 


inconsistency. 


Explanation: During apply processing of a text 

deck, the deck is read from bottom up looking for 

AUX entries. When an AUX entry is found the a 
update file tvne is taken from the first field and a =e 
check has been made of the update file mode in : 
order to determine if the update has been applied. 

The update has been found with a file mode other 

than 5 indicating it is not applied. The AUX file 

was then checked and an entry for this update has 

been located indicating the update has been 

previously applied. 


System Action: Processing by the current 
parthandler will end resulting in the PTF not being 
applied. RC ts set to 4. 


—_ 
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User Response: Investigate if duplicate updates 

exist that have already been applied, indicated by 

having a file mode 5. If so, the current update can 

be renamed to fm5 or erased. If a duplicate is not 

found then the update should be renamed to fmS. 

VMFAPPLY can then be used to reapply this PTF 

or it can be applied manually. a 


This message may indicate that a PTF has ee 
incorrectly been unapplied. It also may indicate 

that update files have been received by a part 

handler other than VMFRCUPD. 


1887W The fn EXEC file was not found. The 
{user exit|part handler} fn was not 


executed. 
Explanation: The specified EXEC was not found. 


System Action: The procedure continues without 
executing the EXEC. 


User Response: If the EXEC was needed for 
processing, ensure that the EXEC 1s available to be A 
executed, and restart the procedure. 4 


oie 


awn 


1888W Product parameter file prodid $PPF has 
been found on file mode fm. It has been 
renamed to prodid $PPFSAVE fm. A 
new product parameter file will be loaded 
from the tape. Merge any local changes 


from the renamed file to the new file. 


Explanation: If you had a copy of the product 
parameter file on the target disk for VMFREC, it 
would be overlaid. A copy is saved as file type 
SPPFSAVE and a new $PPF is loaded down to the 
target disk for VMFREC. 


System Action: The procedure continues. 


User Response: Merge your changes from the 
$PPFSAVE file into the new product parameter file 
loaded down to the target disk. 


1889E The prodid $PPF product parameter file 
contains invalid data on the ppftag record 
Correct the file and retry. 


Explanation: An error has occurred because of 
invalid data contained on the product parameter 
file record indicated by the message text. 


System Action: The procedure exits with RC = 
100. 


User Response: Correct the invalid data, and 
restart the procedure. 


1890E The ppfname $PPF product parameter 
file is invalid. record is missing or out of 
order. Correct the file and retry. 


Explanation: A required record cannot be found in 
the product parameter file. 


System Action: The procedure exits with RC = 
100. 


User Response: Add the required record, and 


restart the procedure. 


1891E Part handler name failed for component 
compname of product ID prodid. 


Explanation: A part handler EXEC that is listed in 
the product parameter file for the component 
indicated by the message text has failed. 


System Action: The VMFBLD procedure exits 
with RC = 100. VMFREC will continue with any 
other prodid components, if the list option was 
specified. 


User Response: Correct the problem that is causing 
the part handler EXEC to fail, and retry the 
procedure. 


1892E The name build list was not found in the 
ppfname $PPF file. 


Explanation: A build list name is missing. 


System Action: The procedure exits with RC = 
100. 


User Response: Add a build list name to the PPF. 


1893E The name tag found in apparent $PPF 
override file ppfname. 


Explanation: A tag was found in a $PPF override 
file that was not expected. The most likely 
possibility is that it is a COMPLST tag. 


System Action: The procedure exits with RC = 
100. 


User Response: Correct the $PPF file and restart 
the procedure. 


1894W Ensure that all parts of prodid compname 
have been received before proceeding to 


the APPLY step. 


Explanation: In order to do a complete APPLY, it 
is necessary that the entire component be received. 
This message is issued if part of the component has 
not been received during this invocation of 
VMFREC. 


System Action: The procedure continues, but will 
exit with RC = 4. 


User Response: Receive the rest of the component, 
if you have not already done so. 


1895E name! tag found {before|after} name2 
tag in ppfname SPPF product parameter 
file. 


Explanation: A tag was not in the proper place in 
the $PPF file. 


System Action: The procedure exits with RC = 
100. 


User Response: Correct the $PPF and restart the 
procedure. 


Appendix J. Messages 883 


1896E The component name is missing from the 
component override tag name. 


Explanation: An override was specified, but no 
base component was listed in the override $PPF 
file. 


System Action: The procedure exits with RC = 
100. 


User Response: Correct the $PPF file, and restart 
the procedure. 


1897E. Error reading file fn ft fm. 
or 
A problem occurred reading file fn ft. 
Explanation: A file required by the procedure 


cannot be read. 


we we 2 


System Action: The procedure exits with RC = 
100. | 


User Response: Correct the problem with the file 
and retry the procedure. Some possible problems 
may be: not enough storage, or bad file pointers. 


1898E A record can not be written to file fn ft 
fm. 


Explanation: A problem has been encountered in 
trying to add a record to a file. 


System Action: The procedure exits with RC = 
100. 


User Response: Correct the problem with the 
minidisk and retry the procedure. The most likely 
cause of this problem is that the minidisk is full. 


1899E There is a problem loading a file. 


Explanation: A problem has been encountered 
writing a file. 


System Action: The procedure exits with RC = 
100. 


User Response: Correct the problem with the 
minidisk and retry the procedure. The most likely 
cause of this problem is that the minidisk is full. 
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1900W The existing ppfname $SETUP A1 file 
has been refreshed. You might want to 
check your access order when done. 


Explanation: VMFSETUP has been invoked for 
accessing two consecutive times, without being 
invoked with the RESTORE option. The first 
access order has been lost. 


System Action: The procedure continues with RC 
= 4, 


User Response: Check your access order at the 
completion of processing. 


1901E VMFSETUP, when invoked with the 
PPFTEMP parameter, expects a 


temporary product parameter file. 
ppfname $PPFTEMP was not found. 


Explanation: VMFSETUP was invoked with the 
PPFTEMP operand. This operand is only to be 
used if VMFOVER has been invoked previously to 
create a $PPFTEMP file. Because no $PPFTEMP 
file was found, VMFOVER could not have run 
successfully. 


System Action: The procedure exits with RC = 28. 


User Response: Invoke VMFOVER before 
executing VMFSETUP, or invoke VMFSETUP 
without the PPFTEMP operand. 


1902E The compname component name was not 
found in the ppfname $PPFTEMIP file. 


Explanation: The $PPF file does not contain a 
section for the specified component. 


System Action: The procedure exits with RC = 
100. 


User Response: Correct the $PPF file, and restart 
the procedure. 


1904E The current access order does not match 
the access order that is in the RELEASE 
section of ppfname $SETUP. Your 
access order will be left as it is. 


Explanation: VMFSETUP cannot restore the 


original access order, because the current access 
order is not the same as the one set up by 
VMFSETUP when it was originally invoked. 


System Action: The current access order is left 
untouched, and the procedure exits with RC = 100. 
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User Response: Check your access order. 


The access of vdev failed with a return 
code of rc. Processing continues for 
product prodid. 


1905W 


Explanation: VMFSETUP was not able to perform 
an access that was listed in the $PPF file. The 
minidisk may not have been linked or formatted. 


System Action: The procedure continues with RC 
= 4, 


User Response: Ensure that the access was not 
needed. If it was needed, you should make the 
minidisk accessible, and then restart the procedure. 


The access of vdev failed with a return 
code of rc. Processing stops for product 
prodid. [The original access order 
cannot be restored. | 


1906E 


Explanation: VMFSETUP was not able to perform 
an access that was listed in the $PPF file. The 
minidisk might not have been linked or formatted. 
It has been determined that this minidisk might be 
essential for processing. 


System Action: The procedure exits with RC = 
100. 7 


User Response: Take whatever steps are needed to 
allow the minidisk to be accessed, then restart the 
procedure. 


19071 Assembling fn [(options)}. 


Explanation: The assembly is going to begin. If 
you specified any assembler options, the options 
used are displayed. 


System Action: The assembly begins. 
User Response: None. 
1908E Error {assembling|updating} /n. 


Explanation: If assembling is taking place, an 
assembler error occurred. If updating is taking 
place, a severe update error occurred. 


System Action: Execution is terminated. 


User Response: Correct the error and rerun. 


| 
| 
| 


1909] fn ft A [has not been] created. 


Explanation: A text file with the given file name 
and file type has been created, or the text file was 
not produced because of assembler errors. 


System Action: None. 


User Response: None. 


Invalid CSECT name csect name for ICS 
card in fn ft. 


1911E 


Explanation: The include control section card has 
an invalid CSECT name specified. 


System Action: The procedure exits with RC = 
100. 


User Response: Correct the ICS card, and restart 
the procedure. 


1912E VER card missing in fn ft. 


Explanation: A VER card was missing, and the 
patch cannot be performed. 


System Action: The procedure exits with RC = 
100. 


User Response: Add a VER card, and restart the 
procedure. 


Part-handler execname for build list 
listname was found in the fn $PPF but a 
target was not specified. 


1932E 


Explanation: The name of the target string for the 
specified part-handler and build list in the BLD 
section of the $PPF file is missing. 


System Action: The procedure ends with RC = 100. 


User Response: Correct the $PPF file and reenter 


the command. 


19371 Merge processing has started for fn/ fn2. 


Explanation: The merge tag in the product 
parameter file contains at least one set of disk 
strings. It has been determined that the component | 
being received has not been previously received and 
that at least one of the first disks of the disk strings 
were not empty. 


System Action: The procedure continues with the 
merge of the disk strings. For each symbolic disk 
string listed on the merge tag, the contents of each 
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disk is moved to the next, starting with the last pair 
in the symbolic disk string. | 


User Response: No response required. 


The merge of symbolic-disk-string-name - 
dskI to dsk2 is complete. 


Explanation: As part of merge processing, files 
from each disk listed in a symbolic disk string are 
moved to the next disk starting with the last pair of 
disks. The contents of dsk1 have been successfully 
copied to dsk2 as a result of processing the 
symbolic disk string indicated in the message. 


System Action: The procedure continues merging 
with the next pair of disks in the symbolic disk 
string. If no other pairs exist then if more symbolic 
disk strings exist on the merge tag, they are 
processed. Otherwise merge is complete. 


User Response: No response required. 


1939] Merge processing is complete for 


component compname. 


Explanation: As part of merge processing, files 
from each disk listed in a symbolic disk string are 
moved to the next disk starting with the last pair of 
disks. This process is repeated for each symbolic 
disk string listed on the merge tag in the product 
parameter file. This message indicates that all 
symbolic disk strings have been merged. 


System Action: The procedure continues receiving 
service for the component specified. 


User Response: No response required. 


19401 Merge processing is not required for 


component compname. 


Explanation: The first disk of each symbolic disk 
string listed on the merge tag in the product 
parameter file has been found to be empty, making 
a merge unnecessary. 


System Action: The procedure continues receiving 
service for the component specified. 


User Response: No response required. 
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| Component compname has already been 
received successfully from PUT|\COR 
tape-identifier. 


1941K 


Explanation: When a tape has successfully been 


received a merge indicator file is written to the first _ 


disk of each symbolic disk string listed on the 
merge tag in the product parameter file. This 
merge indicator has a file name of PUT or COR 
depending on tape type and a file type of “$MR” 
concatenated to the first letter of the tape type - P 
or C, concatenated with the tape identifier. 
Another indicator file with a file name of “$” 
concatenated with the tape type and a file type of 
the tape identifier is created with the comment in 
the COR or PUT DOCUMENT which contains a 
date and time stamp. The tape identifier from the 
“SMR” file is compared to the tape type currently 
being received. If both of these are identical then 
the comment in the second indicator file is 
compared with the comment from the current COR 
or PUT DOCUMENT. If both of these comments 
are identical then this message is issued. 


System Action: The procedure exits with 
RC =100. 


User Response: This message indicates that the 
service from this tape has already been successfully 
received. Check that the correct tape has been 
mounted. Also verify that the correct component 
has been entered. If the real intent is to re-receive 
service for this component then the indicator files 
described above can be renamed or erased so that it 
appears a receive has not been completed. 


19421 Service has been received for partname 
parttype. It is a part of the 


Serviceability Enhancements. 


Explanation: A Serviceability Enhancement part 
has received service. This service includes a new 
executable version for partname. 


System Action: The procedure continues. 


User Response: The executable part shipped for 
partname may be at a lower service level than your 
existing partname. Review the self-documenting 
information at the end of EXECs, XEDIT macros, 
and modules to determine the service levels of the 
new and existing parts. If necessary update the 
executable version used on your system to the latest 
level. Copy the PTF numbered version of the part 
to the executable version. 


Example: 


COPY VMFAPCOM EXC12345 B VMFAPCOM EXEC B 


1943W One or more AUX files have been 
received for manually supported parts. 
The AUX files for these parts must be 
evaluated and may need updating to 
assure the validity of your system. 


Explanation: The AUX file(s) that have been 
received contain AUX entnies for all updates to the 
part being serviced from the base level of the 
product to the update that was received. Some of 
the AUX entries in the new AUX file may already 
appear in other AUX files on your system. Having 
the same AUX entry appear more than once on 
your system can affect your system’s integrity. 


System Action: The procedure continues with 
RC = 4. 


User Response: 


¢ Using the SVMFREC $HISTORY file that was 
created during execution of VMFREC EXEC, 
make a list of all of the AUX files that were 
received. The $VMFREC $HISTORY contains 
entries from all runs of VMFREC EXEC. The 
entries from the latest run are on the bottom 
and are outlined with beginning and ending 
time stamps. 


e For each AUX file received, use the LISTFILE 
command to make a list of all of the existing 
AUX files for this part. 


e Use XEDIT to view CNTRL file that is used 
for the given part. 


¢ Identify the appropriate AUX level in the 
CNTRL file for the given part. For example, if 
you received corrective service and there is an 
AUXCOR level in the CNTRL file, then this 
would be the appropriate level for the new 
AUX file. 


e If necessary, rename the new AUX file so that 
its file type matches the appropriate AUX level 
in the CNTRL file. 


¢ Compare the AUX entries in each AUX file 
level that is below the new AUX file level with 
the AUX entries in the new AUX file. For any 
duplicate entries, use an asterisk (*) to 
comment them out of the new AUX file. 


¢ Compare the AUX entries in the old AUX file 
at the same level as the new AUX file with the 
new AUX file. If the old AUX file at this level 
contains more AUX entries, erase the new one 
or you will down level your system. 


¢ Compare the AUX entries in each AUX file 
level that is above the new AUX file level. For 


any duplicate entries, use an asterisk (*) to 
comment them out of the higher level AUX 
files. If there are any Local Modifications or 
Local Text Patches, you must determine if they 
intersect with the new update and rework them 
if necessary. 


1944E Update file fui ft] fm contains an 
unsupported statement type type for the 
patch facility. 


Explanation: The update file identified in the 
message is a patch update which contains a 
statement other than NAME (Name for CSECT), 
ICS (Included control section), VER (verify), REP 
(replace) or comments. Only these statement types 
are allowed in patch update files. 


System Action: The procedure continues with 
RC = 100. Invalid cards are not included in the 
text deck. 


User Response: While creating the update file, you 
may have incorrectly typed the update statements. 
If so, correct the statement(s) and retry the 
procedure. Incorrect update files can generate a bad 
nucleus, therefore the update file should be 
corrected. 


1946E The com command failed with a return 
code rc. The input file specification was 
Jnl ftl fml. The output file specification 
was fn2 ft2 fm2. 


Explanation: The given CMS command 
experienced a severe error. If there is no input 
specification associated with the command, this part 
of the message is omitted. The same is true for the 
output specification. 


System Action: The procedure continues with RC 
= 100. 


User Response: See the given CMS command for 
more information. 


1947E A 3-character abbreviation could not be 
found for the file type /¢ in the :APP. 
section of prodid prodidft. 


Explanation: Entries in the :APP. section of a 
$PPF (product parameter file) have file types and 
file type abbreviations with which to rename the file 
that is being processed. If a file is being processed 
and its file type abbreviation cannot be found, it is 
an error condition. 
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System Action: The procedure continues with 
RC = 100. 


User Response: Verify that you are using the 
correct level of the PPF and that it contains the 
required abbreviation in the :APP. section of the 
component that you are servicing. 


1948W AUX file fn ft on cuu must be renamed 
by its file type abbreviation and a PTF 
number, but it does not contain a PTF 


number. It is being renamed to fn /t2. 


Explanation: AUX files that are supplied on 
service tapes have file types that may be listed in a 
control file. To avoid the new AUX file from being 


picked up and possibly conflicting with your system 


it must be renamed. The new file type is the 
3-character abbreviation for the AUX file which is 
found in the product parameter file (PPF) 
concatenated with the PTF number found in the 
top AUX entry in the AUX file. Since the AUX 
file does not contain any valid PTF numbers, the 
new file type will be only the 3-character 
abbreviation. | 


System Action: The procedure continues with 
RC=4. 


User Response: None. 


1949W PTF ptfnum for product prodid has 


already been applied. 


Explanation: A PTF was included in the apply list 
that had already been successfully applied. This 
determination was made by looking at the file mode 
of the $PTFPART file for this PTF. A file mode 
of 5 indicates that the PTF has been completely 
applied. 


System Action: The procedure continues with 
RC=0. 


User Response: None. 


1953W jn was interrupted the last time it was 
run. fn $ERRLOG has been restored 
from the saved history file /n 


SOLDLOG. 


Explanation: A copy of the S$ERRLOG named 
$VMFREC, $SVMFAPP, or $VMFBLD 
SOLDLOG is saved each time VMFREC, 
VMFAPPLY, or VMFBLD is invoked. If for some 
reason the execution of the EXEC is not completed 
(for example, if the user enters “HX” or the system 
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abends) the $VMFxxx $OLDLOG remains on the 
users’ A-disk. 


Subsequent VMFREC, VMFAPPLY, or VMFBLD 
invocations append the $VMFxxx $0LDLOG to 
the new $VMFxxx ERRLOG and erase the 
$VMFxxx $0LDLOG. The $VMFxxx $0LDLOG 
will not exist after a complete run of the associated 
EXEC because it is eraseed, however the user 
should never erase the $VMFxxx $0LDLOG unless 
they do not want this historical exception log 
information. 


System Action: This message has no effect on 
system action. 


User Response: Investigate the previous messages 
to determine if further action is required. 


19601 W The Service Enhancement parts have 
been received from the tape header files 


but they have NOT been activated. 


Explanation: VMFREC has received the service 
execs from the first two tape files but due to a 
detected inconsistency they have not been renamed 
to their executable form(s). 


System Action: RC = 4. 


User Response: Examine other messages issued to 
determine the nature of the inconsistency, correct it 
and rerun VMFREC INFO. 


1962W No PTF numbered Service Enhancement 


parts were found in the tape header files. 


Explanation: VMFREC has determined that no 
Service Enhancement EXECs or related parts exist 
as PT F-numbered files in tape files one or two. 


System Action: RC = 4. 


User Response: If PTF-numbered service EXECs 
were expected to be on the tape determine why they 
are missing. If the tape was created prior to having 
PTF-numbered service enhancement parts in the 
tape header files then no action is required. 


19631 Level nnnn of the Service Enhancement 


parts is now established on mode cuu. 


Explanation: VMFREC has loaded the indicated 
level of the service EXECs onto the reported disk 
and renamed them so that they are executable. 


System Action: RC = 0. 


User Response: None 


1964E The update of the Service Enhancements 
part set inventory file SLEVEL EXEC 


was unsuccessful. 


Explanation: VMFREC was unable to write the 
$LEVEL EXEC file to disk while creating or 
updating it. This file contains a list of the service 
EXECs and associated parts that have been 
installed on the users system. 


System Action: RC = 100. 


User Response: Ensure that the target disk [A|C] 
is writable and rerun VMFREC INFO. 


The name command has failed with 
Return Code rc while operating upon file 
fn ft fm cuu execution is terminated. 


1965E 


Explanation: The program was unable to execute 
the reported CMS command while operating on a 
CMS file. 


System Action: RC = 100. 


User Response: Use the reported command name, 
return code and file specified to determine the 
appropriate action to take. 


19661 The fn ft fm (cuu) file saved as fn ft fm 


(cuu). 


Explanation: VMFREC has saved the existing 
service EXECs and associated parts prior to 
receiving a new version of these files. 


System Action: RC = 0. 


User Response: None 


The Service Enhancements part set [on 
DISK mode (cuu) | in the TAPE header 
files] is at the nnnn level. 


19671 


Explanation: The level of the service EXECs and 
associated parts that is on the user’s system is 
always reported. This is extracted from the 


$LEVEL EXEC file. 


The level of the service EXECs and associated parts 
on the service tape is reported if it differs from the 
level the user has installed. 


System Action: RC = 0. 


User Response: If the reported level on disk differs 
from what is expected, determine why before 
proceeding. 

When the level on the tape is more current than the 
level on disk, examine the documentation supplied 
with the tape to determine if the new EXECs 
should be received via VMFREC INFO. 


1968W The Service Enhancements part set on 


DISK is at an UNKNOWN level 
or 


The Service Enhancements part set in the 
TAPE header files is at an UNKNOWN 
level. 


Explanation: Either VMFREC was unable to 
determine the level of the service EXECs on the 
user’s system because it could not find a $LEVEL 
EXEC file, or 

VMFREC was unable to determine the level of the 
service EXECs on the service tape even though it 
contains some service enhancements parts in files 
one and two of the tape. 


System Action: RC = 4. 


User Response: Determine why VMFREC is 
unable to find the $LEVEL EXEC file. Reestablish 
it manually or by running VMFREC INFO. 

If the tape level is unknown, request a new service 
tape from IBM. 


The Service Enhancements part set in the 
tape header files, specified by $LEVEL 
STAPE, conflicts with the tape inventory 
file SLEVEL MAP. 


Explanation: VMFREC has found an 
inconsistency between the tape’s inventory of 
service EXEC parts and the actual parts in tape 
files one and two. The tape is in error. 


1969W 


System Action: RC = 4. 


User Response: Request a new service tape from 
IBM. 
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1970W Entry for PTF ptfno, cannot be found in 


any AUX file for file name. 


Explanation: VMFAPPLY is processing a list of 
all AUX file entries for the part identified in the 
message. 


VMFAPPLY is attempting to verify that the PTF 
which contains service for this part exists in that list 
of AUX file entries but it cannot be found. (The 
PTF number would be in the third token of this list 
of AUX file entries.) 


System Action: Processing continues. 


User Response: This PTF is listed in the 
$APPLIST (apply list) but is not part of any AUX 
file for this part on your system. An AUX file on 
your system may be in error or the $APPLIST you 
are using may be in error. An AUX file could be in 
error because IBM shipped you an incorrect AUX 
file or you may have modified an AUX file that 
was sent to you from IBM. 


Contact your IBM service representative for 
assistance. 


1972W The service tape part inventory file 


$LEVEL MAP, is missing from the tape. 


Explanation: VMFREC is unable to find a 
$LEVEL MAP file in tape file 1 of the service tape. 
Either the tape is in the old format or it is in error. 


System Action: RC = 4. 


User Response: If the tape was expected to have 
PTF numbered service parts in files one and two 
then order a new service tape. 
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1973W The service tape may be in the old 
format. Using INFO (ALL may back — 


level your Service EXECs). 


Explanation: VMFREC has determined that the — 
service tape may be in the old format and using the 
VMFREC INFO (ALL command may receive 
back level executable parts onto your disk. 


System Action: RC = 4. 


User Response: Do not use VMFREC INFO (ALL 
unless you know it will not destroy your production 
service EXECs. 


A $PPF file for product prod-id exists on 
this tape volume but is not installed on 
your system. It must be received prior to 
servicing that product. 


Explanation: VMFREC has checked the $PPF files 
in tape file two of the service tape and has 
determined that a $PPF file exists on the tape that 
is not listed in the $LEVEL EXEC file. 


System Action: RC = 0. 


1974] 


User Response: Before servicing the indicated 
product ensure that its new $PPF has been installed 
on your system. 


1975W # An UNKNOWN level of the Service 
Enhancement parts are now established 


on mode cuu. 


Explanation: VMFREC INFO (ALL was used in a 
situation that prevents VMFREC from knowing the 
level of the service EXECs and other parts received 
from files 1 and 2 of the service tape. 


System Action: RC = 4. 


User Response: Before performing additional 
service, ensure that the new service EXECs are 
those you wish to have installed. 


Summary of Changes 


Technical changes throughout this manual are indicated by vertical bars (|) to the left of the changed 
material. 


Third Edition 


Form of Publication: SC23-0364-2 
Level of Product: VM/XA System Product Release 2 
Date of Publication: March 1989 


Changes to this publication: 
( . ¢ New device support. 


VM/XA System Product Release 2 fully supports the 3380-K DASD device. The 3380 Starter System 
can be used with a 3380-K. A new sample directory and minidisk maps for the 3380-K have been added 
to Appendix C, “VM/XA System Product Starter System Information.” 


¢ Group control system (GCS). 


GCS is a new component that allows you to implement a native SNA communication network or run 
RSCS Version 2. 


( “ — A discussion of planning for GCS has been added to Chapter 1, “Introduction.” 


— Instructions for installing GCS have been added to Chapter 2, “Installing VM/XA System Product 
Release 2 with the Starter System (First Level),” and Chapter 3, “Installing VM/XA System Product 
Release 2 with the Starter System (Second Level)” on page 115. 


— Anew chapter, Chapter 16, “Program Update Service or Corrective Service to GCS,” shows how to 
service your GCS system. 


— A new appendix, Appendix E, “Example of Alternate GCS Nucleus Placement,” shows how to save 
your GCS nucleus at a different location than the one in the sample files. 


( - ¢ CP national language support (NLS). 
- VM/XA System Product Release 2 provides CP HELP files and messages in the following languages: 


— Mixed-case American English (base version) 
— Uppercase American English 

— French 

— German | 

— Brazilian Portuguese 

— Japanese (Kanji). 


A discussion of planning for national language support has been added to Chapter 1, “Introduction”; 
and Chapter 5, “Installing a New System National Language,” gives instructions for installing a new 
system national language. 


e DIRECTXA enhancements. 


VM/XA System Product Release 2 enhances the function of the DIRECTXA command and the directory 
| build process by providing automatic deactivation of restricted passwords (ADRP). Appendix F, 
“Restricted Logon Passwords,” gives the restricted password list supplied by IBM. 
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¢ Installation using an existing system. 


— A new chapter, Chapter 4, “Installing VM/XA System Product Release 2 Using an Existing VM/SP 
or VM/SP HPO System,” shows how to install VM/XA System Product Release 2 using an existing 
VM/SP or VM/SP HPO system. 


— Sample directory entries for the virtual machine used to install VM/XA System Product Release 2 
using an existing system appear in Appendix C, “VM/XA System Product Starter System 
Information.” | 


e Corrective Service. 


The procedures for applying corrective service have been brought into line with the procedures for 
applying program update service. Information on corrective service appears throughout Part 2, 
“Servicing the System.” 


¢ Serviceability Enhancements. 
— The following new service EXECs have been developed: 


— VMFOVER EXEC overrides the product parameter file “a 
— WMFSETUP EXEC establishes the correct minidisk access order for the other service EXECs. | 


The new service EXECs are discussed in Appendix B, “EXEC and Command Format Summaries” 
and throughout Part 2, “Servicing the System.” 


— A new appendix, Appendix G, “Controlling Disk String Merges,” shows how to perform the disk 
string merges normally done by the VMFREC EXEC manually and how to prevent VMFREC from 
merging a string. 


e Servicing CP and CMS. 


The chapters on servicing CP and CMS (formerly Chapter 9, “Applying Program Update Service to CP,” “er 
and Chapter 10, “Applying Program Update Service to CMS”) have been reorganized to reflect the order 8 
of the service process. The new chapters are: 


Chapter 9, “Receiving Program Update Service or Corrective Service for CMS” 
Chapter 10, “Receiving Program Update Service or Corrective Service for CP” 
Chapter 11, “Applying Program Update Service or Corrective Service to CMS” 
Chapter 12, “Applying Program Update Service or Corrective Service to CP” 
Chapter 13, “Rebuilding CMS after Applying Service” 

Chapter 14, “Rebuilding CP after Applying Service.” 


e Servicing the Dump Viewing Facility. 


, 

f 

‘ ® 
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A new chapter, Chapter 15, “Program Update Service or Corrective Service to the Dump Viewing 
Facility,” shows how to service the dump viewing facility. 


e Local Service. 


The chapters on applying local service (formerly Chapter 12, “Applying Local Service to CP,” and 
Chapter 13, “Applying Local Service to CMS”) have been rewritten. The new chapters are: 


Chapter 18, “Receiving and Applying Local Service” 
Chapter 19, “Emergency Local Service Using the Patch Facility.” 


¢ Removing Service. 
The chapter on removing service, Chapter 20, “Removing Service from VM/XA SP,” has been rewritten. 
¢ Other service information. 


— A new appendix, Appendix H, “Service Reference Tables,” lists the standard 3-character 
abbreviations for the various file types used in VM/XA SP and the parts supplied for service. 
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A new appendix, Appendix 1, “How To Find the PTF Number From the APAR Number,” shows 
the procedure for determining the number of a program temporary fix from the associated APAR 


number. 


¢ Duplicate information deleted. 
The following chapters have been deleted because they duplicate material found in VM/XA SP Planning 
and Administration: 


Chapter 4, “CMS as a Named Saved System” 
Chapter 5, “Licensed Program Planning”’. 
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Glossary 


A 


APAR. Authorized program analysis report. 


authorized problem analysis report (APAR). (1) A 
report of a specific system problem. (2) The code 
correcting a specific system problem. 


automatic software re-IPL. The process by which 
the control program attempts to restart the system 
after abnormal termination. This process does not 
involve the hardware IPL process. See also 

virtual = real machine recovery. 


C 


CCS. Console communication services. 
CCW. Channel command word. 


channel command word (CCW). A doubleword 
structure that directs an I/O operation on a device 
or channel and includes pointers to any storage 
areas associated with the operation. One or more 
CCWs make up a channel program. 


circumventive fix. A fix that branches around the 
code in error, or avoids executing that code in some 
other way, rather than correcting the error. A 
circumventive fix 1s temporary. 


CMS. Conversational monitor system. 


control program (CP). The component of VM/XA 
SP that manages the resources of a single 
System/370-Extended Architecture system so that 
multiple computing systems appear to exist. Each 
virtual machine is the functional equivalent of 
either a System/370 computing system or a 
System/370-Extended Architecture computing 
system. 


console communication services (CCS). A group of 
CP routines that interface with the VTAM service 
machine, providing full VM/XA SP console 
capabilities for SNA/CCS terminal users. 


conversational monitor system (CMS). The 
component of VM/XA SP that, as a virtual 
machine operating system, provides interactive 
time-sharing. CMS allows users to communicate 


with the system and with each other, to create and 
edit files, and to develop and run application 
programs. It operates in either System/370 mode or 
370-XA mode under the control of CP. 


COR. Corrective service tape. 


COR-closed PTF. A PTF that is available on a 
corrective service tape. 


CP. Control program. 


corrective service. Service sent to you by IBM to 
correct a specific problem, supplied on a corrective 
service tape in the same format as a program 
update tape. 


corrective service tape (COR). A tape containing 
customized corrective service, sent to you by IBM. 


D 


DCSS. Discontiguous saved segment. 


directory. A CP disk file that includes an entry for 
each user in the system. The entry defines the 
characteristics of the user’s initial virtual machine 
configuration. These characteristics include the 
user ID, the password, normal and maximum 
allowable virtual storage, virtual device definitions, 
the privilege class, the dispatching priority, logical 
line editing characters, and the account number. 


discontiguous saved segment (DCSS). A saved 
segment that occupies one or more 
architecturally-defined segments. It begins and ends 
on segment boundaries. It is accessed by its own 
name. Contrast with member saved segment. See 
also saved segment, segment, segment space. 


disk string. See string. 


dump viewing facility. A VM/XA SP component 
that allows users to display, format, and print data 
interactively from CP hard and soft abend, 
stand-alone, and virtual machine dumps, and to 
process CP trace table data stored on tape or in a 
system trace file. 


dynamic paging area. The area of real storage 
allocated by CP for V=V machine paging. This 
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area also contains CP nonresident modules, CP 
control blocks, CP trace tables, free storage pages, 
and the alternate processor’s prefix storage areas. 


E 


Expanded Storage. Optional integrated high-speed 
storage. In VM/XA SP, Expanded Storage may be 
shared by CP and one or more virtual machines. It 
may also be dedicated to CP or to a particular 
virtual machine. | 


fe 


full-pack minidisk. A virtual disk that contains all 
of the addressable cylinders of a real DASD 
volume. 

full-screen mode. [i VM/XA SP, ihe environment 
in which an entire 3270 display screen is under the 
control of a program running in a virtual machine. 


G 


GCS. group control system 


group control system (GCS). The component of 
VM/XA SP that, as a virtual machine supervisor, 
executes in a group of System/370 virtual machines 
under CP control to provide an interface that helps 
support a native Systems Network Architecture 
(SNA) network. 


guest. An operating system running in a virtual 
machine managed by the VM/XA SP control 
program. Contrast with host. 


guest real storage. The storage that appears real to 
the operating system running in a virtual machine. 
Contrast with guest virtual storage, host real 
storage, and host virtual storage. 


guest virtual storage. The storage that appears 
virtual to the operating system running in a virtual 
machine. Contrast with guest real storage, host real 
storage, and host virtual storage. 


H 


host. The VM/XA SP control program in its 
capacity as manager of a virtual machine in which 
another operating system is running. Contrast with 
guest. 
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host real storage. The storage that appears real to 
the control program. If VM/XA SP is running 
native, this is real storage; if VM/XA SP is running 
in a virtual machine, this is virtual storage. 
Contrast with guest real storage, guest virtual 
storage, and host virtual storage. 


host virtual storage. The storage that appears 
virtual to the control program. Contrast with guest 
real storage, guest virtual storage, and host real 
storage. 


image library. A set of modules, contained in a 

system data file, that define the spacing, characters, 

and copy modification data that a 3800 printer uses 

to print a spool file or that define the spacing and — 
character set that an imnact printer uses to print a | : 
spool file. See also system data file. 


inter-user communication vehicle (IUCV). A 
generalized CP interface that facilitates the transfer 
of data among virtual machines. 


IUCV. Inter-user communication vehicle. 


local service. Any service not supplied on a PUT 
or COR tape. It can be service that you originate, 
or service that is sent to you by IBM to correct or 
circumvent a specific problem that you have 
encountered and reported. Local service can be 
supplied on a tape, in hard copy, or over the phone. 


M \ 
f 


member saved segment. A saved segment that 
begins and ends on a page boundary. It belongs to 
from | to 64 segment spaces and is accessed either 
by the segment space name or its own name. 
Contrast with discontiguous saved segment. See 


also saved segment, segment, segment space. 


message repository file. A type of system data file 
that contains a set of VM/XA SP messages 
translated into a national language. 


minidisk string. See string. 
missing interrupt handler. A CP function for 


detecting and dealing with real I/O operations that 
do not complete within a specified time. 


multiple preferred guests. A VM/XA SP facility 
that supports up to six preferred virtual machines 
when the Processor Resource/Systems Manager™ 
(PR/SM™) feature is installed in the real machine. 
See also preferred virtual machine. 


N 


named saved system (NSS). A copy of an operating 
system that a user has named and retained in a 
system data file. The user can load the operating 
system by its name, which is more efficient than 
loading it by device number. See also discontiguous 
saved segment, member saved segment, saved 
segment, segment space, system data file. 


NSS. Named saved system. 


O 


object-maintained code. Code serviced by 
replacement of a complete part. See also 
replacement service, source-maintained code. 


P 


pageable virtual machine. Synonymous with 
virtual = virtual machine. 


preferred virtual machine. A virtual machine that 
runs in the V=R area. CP gives this virtual 
machine preferred treatment in the areas of 
performance, processor assignment, and I/O 
interrupt handling. See also multiple preferred 
guests, virtual = fixed machine, virtual = real area, 
virtual = real machine. 


preventive service. Program update service. 


Processor Resource/Systems Manager (PR/SM). A 
separately orderable feature available with 3090E 
processors that provides for logical partitioning of 
the real machine and support of multiple preferred 
guests. See also multiple preferred guests. 


PR/SM. Processor Resource/Systems Manager. 


program temporary fix (PTF). A package of one or 
more APARs. 


program update service. Service sent to you ona 
program update tape, also called preventive service. 
Not to be confused with update service. 


program update tape (PUT). A tape containing 
customized service. Each service tape contains 
cumulative service for the customer’s products back 
to the earliest release level of the product still 
supported. 


PTF. Program temporary fix. 


PUT. Program update tape. 


R 


real system operator. Any user who loads and runs 
VM/XA SP in the real machine. Contrast with 
virtual machine operator. 


remedial service. Service to temporarily correct or 
circumvent a specific problem that you have 
encountered and reported, until a PTF becomes 
available. Remedial service includes corrective 
service, which IBM supplies on a corrective service 
tape with the same format as a program update 
tape, and local service, which IBM supplies in some 
other format or which you originate yourself. 


replacement service. Service by replacement of the 
entire part that is in error. See also 
object-maintained code, update service. 


S 


saved segment. One or more pages of storage that 
have been named and retained in a system data file. 
See also discontiguous saved segment, member 
saved segment, segment, segment space, system data 
file. 


segment. In System/370 architecture, 64 kilobytes 
of storage. In 370-XA architecture, | megabyte of 
storage. See also saved segment. 


segment space. A saved segment composed of up 
to 64 member saved segments accessed by a single 
name. A segment space occupies one or more 
architecturally-defined segments; it begins and ends 
on segment boundaries. A user with access to a 


Processor Resource/Systems Manager and PR/SM are trademarks of the International Business Machines 


Corporation. 
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segment space has access to all of its members. See 
also discontiguous saved segment, member saved 
segment, saved segment, segment. 


service tape. Program update tape or corrective 
service tape. 


service virtual machine. A virtual machine that 
provides system services. These services include 
accounting, error recording, monitoring, and those 
provided by supported licensed programs. 


SMSG function. A CP function that allows a 
virtual machine to send a special message to 
another virtual machine programmed to accept and 
process the message. See also special message. 


SNA. Systems Network Architecture 


SNA/CCS terminal. Any terminal arceccina 


Seay — er eWEALAAAACLSL Mew wwollif, 


VM/XA SP that is anne’ by a VTAM service 
machine. | 


source-maintained code. Code serviced by 
combining updates with the base code. See also 
update service, object-maintained code. 


special message. A data transmission, made up of 
instructions or commands, sent from one virtual 
machine to another via the SMSG function. A 
special message is processed by the receiving virtual 
machine and does not appear on the receiver's 
console. See also SMSG function. 


spool file. A collection of data along with CCWs 
for processing on a unit record device. Contrast 
with system data file. 


string. In applying service, a set of minidisks 
defined in the product parameter file for a 
particular use; for example, the BASE2 string, 
which holds source code, or the DELTA| string, 
which holds update files from the program update 
tape. 


SVC 76. In VM/XA SP, a supervisor call 
instruction that records the error incidents 
encountered by certain operating systems running in 
virtual machines. When a virtual machine 
operating system issues an SVC 76, VM/XA SP 
translates the virtual storage and I/O device 
addresses to real addresses, records the information 
on the VM/XA SP error recording virtual machine, 
and returns control to the issuing virtual machine. 


898 Installation and Service 


This interface bypasses the virtual machine’s own — 
error recording routine, and avoids duplicate error 
recording. 


System/370 mode. A virtual machine operating 
mode in which System/370 functions are simulated. 
Contrast with 370-XA mode. 


system data file. A collection of data associated 
with a particular function. Types of system data 
files include saved segments, NSSs, UCR files, 
image libraries, message repository files, and system 
trace files. Because a system data file contains no 
CCWs, it cannot be processed on a unit record 
device. Contrast with spool file. 


system hold status. A spool file status that prevents 
a file from being printed, punched, or read until the 
real system operator releases it. Contrast with user 
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system trace file. A type of system data file that 
contains CP or virtual machine trace data. 


Systems Network Architecture (SNA). The 
description of the logical structure, formats, 
protocols, and operational sequences for 
transmitting information units through, and 
controlling the configuration of, networks. 


U 


UCR file. User class restructure file. 
unit record device. A reader, a printer, or a punch. 


update service. Service by applying updates to the 
base code (also called source code) that 1s in error. 
Not to be confused with program update service. 
See also source-maintained code, replacement 
service. 


user class restructure file (UCR file). A type of 
system data file that contains information used to 
override the IBM-defined privilege class structure of 
CP commands, DIAGNOSE instruction codes, and 
certain CP system functions. 


user directory. See directory. 


user hold status. A spool file status that prevents a 
file from being printed, punched, or read until the 
file owner releases it. Contrast with system hold 
status. 


Me 
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Vector Facility (VF). A hardware feature that 
provides synchronous instruction processing for 
high-speed manipulation of fixed-point and 
floating-point data. 


VF. Vector Facility. 
V=F machine. Virtual = fixed machine. 


virtual = fixed machine (V =F machine). A 
preferred virtual machine with a fixed, contiguous 
area of host real storage that does not start at page 
0. CP provides performance enhancements for this 
virtual machine. See also multiple preferred guests, 
preferred virtual machine, virtual = real area, 
virtual = real machine, virtual = virtual machine. 


virtual machine. In VM/XA SP, a functional 
equivalent of either a System/370 computing system 
or a System/370-Extended Architecture computing 
system. Each virtual machine is controlled by an 
operating system. VM/XA SP controls the 
concurrent execution of multiple virtual machines 
on an actual System/370-Extended Architecture 
system. 


Virtual Machine/Extended Architecture System 
Product (VM/XA SP). An operating system that 
allows multiple IBM System/370 and 370-XA 
operating systems to run simultaneously on a single 
370-XA processor. The multiple systems may be 
used for production, testing, developing application 
programs, maintenance, and migration. VM/XA 
SP also provides a high-capacity interactive 
environment. There are four components: the 
control program (CP), the conversational monitor 
system (CMS), the dump viewing facility, and the 
group control system (GCS). 


virtual machine operator.. Any user who loads and 
runs an operating system in a virtual machine. 
Contrast with real system operator. 


virtual = real area (V=R area). A fixed, contiguous 
section of real storage, starting at page 0, in which 
preferred virtual machines execute. CP does not 
page this storage. See also preferred virtual 
machine, virtual = fixed machine, virtual = real 
machine. 


virtual = real machine (V=R machine). A preferred 
virtual machine with a fixed, contiguous area of 
host real storage that starts at page 0. CP provides 


performance enhancements and an automatic 
recovery facility for this virtual machine. See also 
multiple preferred guests, preferred virtual machine, 
virtual = real area, virtual=real machine recovery, 
virtual = virtual machine. 


virtual = real machine recovery (V =R machine 
recovery). A CP function that allows the V=R 
machine to resume operation after most CP 
abnormal terminations. When possible, the facility 
reestablishes the V=R machine environment, 
allowing the operating system running in that 
virtual machine to perform its own recovery 
processes. See also automatic software re-IPL. 


virtual = virtual machine (V=V machine). A virtual 
machine that runs in the dynamic paging area. CP 
pages this virtual machine’s guest real storage in 
and out of host real storage. See also dynamic 
paging area, virtual = fixed machine, virtual = real 
machine. 


virtual supervisor state. A condition, controlled by 
a virtual machine’s current PSW, during which the 
control program allows the virtual machine to issue 
input/output and other privileged instructions. 

When these instructions are not emulated, the 
control program intercepts these instructions and 
simulates their functions for the virtual machine. 


virtual wait time. The period during which the 
control program suspends the processing of a 
program while a required resource is unavailable. 


VM/XA SP. Virtual Machine/Extended 
Architecture System Product. 


VTAM service machine. A collection of networking 
programs running in a virtual machine that, 
together with the CP console communication 
services (CCS) routines, provide full VM/XA SP 
console capabilities for SNA/CCS terminal users. 

A VTAM service machine contains either (1) 
VM/VTAM with VSCS running as an application 
under control of GCS, or (2) VM/VCNA running 
as a VTAM application under control of the VSE 
or VSI operating system. 


V=R area. Virtual=real area. 
V=R machine. Virtual =real machine. 


V=R machine recovery. Virtual=real machine 
recovery. 


V=V machine. Virtual=virtual machine. 
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370 mode. Synonym for System/370 mode. 


370-XA mode. A virtual machine operating mode 
in which System/370-Extended Architecture 
functions are simulated. Contrast with System/370 
mode. 
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Bibliography 


This bibliography gives the names and order numbers of microfiche and publications about VM/XA System 
Product. 


VM/XA System Product Microfiche 


You can order microfiche listings that contain code. The order numbers for the microfiche are: 
Order No. Description 

LYC7-0330 VM/XA System Product: CP listings 

LYC7-0331 VM/XA System Product: CMS listings 

LYC7-0332 VM/XA System Product: GCS listings 

LYC7-0334 VM/XA System Product: dump viewing facility listings. 


VM/XA System Product Publications 


The publications are shown in Figure 65 on page 902. You can order any of them by their individual order 
numbers or you can order most of them as a group by using a single order number, SBOF-0260. SBOF-0260 
provides: 


e All unlicensed publications (order numbers that do not begin with LY) 
e Enough three-ring binders to hold the publications 
e Spine and cover inserts for the binders. 


_Note that you must order manuals that contain licensed information (manuals with order numbers that begin 


with LY) through your support personnel. Books that contain licensed information are: 


VM/XA System Product: Features Summary, LY27-8058 

VM/XA System Product: Diagnosis Guide, LY27-8056 

VM/XA System Product: CP Diagnosis Reference, LY27-8054 

VM/XA System Product: CMS Diagnosis Reference, LY27-8052 

VM/XA System Product: Group Control System Diagnosis Reference, LY27-8060 
VM/XA System Product: CP Data Areas and Control Blocks, LY27-8053 
VM/XA System Product: CMS Data Areas and Control Blocks, LY27-8051. 


As shown in Figure 65 on page 902, VM/XA SP publications are organized into six categories: 
1. Evaluation and introduction: information on VM/XA SP concepts. 


2. Planning, installation, administration, and service: planning your system and performing system 
installation and maintenance. 


. Operation and end use: performing system and virtual machine tasks. 
. Application programming: information on using programming interfaces. 


Diagnosis: information for understanding of VM/XA SP design and to aid in problem diagnosis. 


Dn Rw 


Reference: quick retrieving of library usage information, command language syntax, macro instructions, 
DIAGNOSE codes, and system messages. 
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Evaluation 


VM/XA 
System Produci 


VM 
at a Glance: 
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GC23-0360 


Planning and Administration 


System Product 


Planning and 
Administration 
GC23-0378 


System Product 


CP Command 
Reference 
$C23-0358 


System Product 


Quick Reference 
$X23-0391 
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System Product 


General 
Information 
GC23-0362 


VM/XA 
System Product 


Conversion 
Notebook 
$C23-0357 


System Product 


CMS Command 
Reference 
$C23-0354 


System Product 


System Product 
Editor 
User’s Guide 
$C23-0373 


VM/XA 
System Product 


Licensed 
Program 
Specifications 
GC23-0366 


System Product 


Features 
Summary 
L.Y27-8058 


System Product 


CMS 
User’s Guide 
$C23-0356 


System Product 


System Product 
Editor — 
Command and 
Macro Reference 
$C23-0372 


Installation 


System Product 


Installation 
and Service 
$C23-0364 


System Product 


Real System 
Operation 
$C23-0371 


VM/XA 
System Product 


CMS Primer 
$C23-0368 


System Product 


Library Guide, 

Glossary, and 

Master Index 
GC23-0367 


VM/XA 
System Product 


Virtual 
Machine 


OAneration 


| $C23-0377 ) 


VM/XA 
System Product 


CMS Primer 

Summary of 
Commands 
$C23-0421 


Evaluation and Introduction: Understanding Basic System Concepts 


The evaluation and introduction publications for VM/XA SP are: 


¢ VM/XA System Product: Licensed Program Specifications, GC23-0366 


Provides information on the warranted functions of VM/XA SP and describes the specified operating 


environment. 


¢ VM ata Glance: Large Systems, GC23-0360 


Presents an overview of the features of each of the large VM systems: the VM/XA Systems Facility, 
VM/SP High Performance Option, and VM/XA System Product. 


¢ VM/XA System Product: General Information, GC23-0362 
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System Product 


CP 
Programming 
Services 
$C 23-0370 


VM/XA 
System Product 


GCS Command 
and Macro 
Reference 
$C23-0433 


System Product 


CMS 
Application 
Program 
Development 
Guide 
$C 23-0355 


VM/XA 
System Product 


System Product 
interpreter 
User’s Guide 
$C23-0375 


System Product 


CMS 
Application 
Program 
Development 
Reference 
$C23-0402 


VM/XA 
System Product 


System Product 
Interpreter 
Reference 
$C23-0374 


System Product 


CMS 
Application 
Program 
Conversion 
Guide 
$C23-0403 


System Product 


EXEC2 Reference 
$C23-0361 


System Product 


Application 


Development 
Guide 
for FORTRAN 
and COBOL 
$C23-0369 


System Product 


Directory of 
Programming 
interfaces 
for Customers 


GC23-0434 


VM/XA VM/XA | 


System Product System Product System Product System Product System Product 
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Reference Diagnosis Diagnosis 
LY27-8054 Reference Reference 
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and Codes Guide 
Reference LY 27-8056 
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Provides general and planning information for VM/XA SP. It can help you decide whether VM/XA SP 
can fill your needs. 
¢ VM/XA System Product: Conversion Notebook, SC23-0357 


Provides migration and compatibility information for customers migrating from VM/SP HPO Release 5 
ae and VM/XA SF Release 2. 
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Planning, Installation, Service, and Administration: Generating and 
Maintaining the System 


| © VM/XA System Product: Planning and Administration, GC23-0378 


| Presents system planning concepts for VM/XA SP and virtual machine planning concepts for guest 

| operating systems. Planning topics include suggestions for defining your real system configuration and 
| building and updating your directory. This book discusses running these operating systems under 

| VM/XA SP: MVS/SP, MVS/XA™, VSE/SP, VM/SP, and VM/SP HPO. 


| This book also provides information on how to manage your system. Administration topics include: 


| — Setting up virtual machines for accounting, error recording, and CMS batch 
| — Setting up the programmable operator 

| — Redefining command privilege classes 

| — Defining and managing saved segments and named saved systems 

| — Tuning the system 

| — Reference information on the VM/XA SP monitor. 


¢ VM/XA System Product: Installation and Service, SC23-0364 | (“ ~\ 
Gives step-by-step procedures for generating VM/XA SP and describes how to apply service updates to Se? 
your system. 

Operations and End Use: Making the System Work for You 

¢ VM/XA System Product: Real System Operation, S$C23-0371 
Provides a task-oriented source for real system operations. In step-by-step format it describes the 
procedures and commands used to perform each real system task. o~ 

¢ VM/XA System Product: Virtual Machine Operation, SC23-0377 re, 


Provides a task-oriented source for virtual machine operations. In step-by-step format it describes the 
procedures and commands used to perform each virtual machine task. 


¢ VM/XA System Product: CMS User's Guide, SC23-0356 

Provides information on using CMS. | 
¢ VM/XA System Product: CMS Primer, SC23-0368 

Provides a tutorial approach to learning CMS. ges 
¢ VM/XA System Product: System Product Editor User’s Guide, SC23-0373 Nec 


Provides information about using the System Product Editor. 


Application Programming: Using Programming Interfaces 
¢ VM/XA System Product: CP Programming Services, SC23-0370 
Provides reference and usage information for the following CP services and macros: 


— The DIAGNOSE codes 
— The IUCV macro 
— CP system services. 


| MVS/XA is a trademark of the International Business Machines Corporation. 
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VM/XA System Product: CMS Application Program Development Guide, SC23-0355 


Helps you use the assembler language macros and functions of CMS in your assembler language 
application programs. Jt describes how to manage storage, perform I/O, handle interrupts, process 
abends, load and start programs, and exploit 31-bit addressing. It also includes message repository 
information. 


VM/XA System Product: CMS Application Program Conversion Guide, SC23-0403 


Helps you convert your existing CMS assembler language application programs so that they run on the 
CMS provided with VM/XA SP. It summarizes the differences between the CMS provided with VM/XA 
SP and previous versions of CMS, it describes the tasks you may need to perform in converting your 
programs, and it points you towards other books that can help you convert your programs. 


VM/XA System Product: Application Development Guide for FORTRAN and COBOL, SC23-0369 


Provides information on how to use the CMS environment to develop and execute FORTRAN and 
COBOL application programs. The book contains such information as: 


— How to use the System Product Editor to create an application program 
— How to load, compile, and execute selected supported licensed programs. 


VM/XA System Product: System Product Interpreter User's Guide, SC23-0375 
Provides information about using the System Product Interpreter. 
VM/XA System Product: Directory of Programming Interfaces for Customers, GC23-0434 


Helps you locate application programming interface information in the VM/XA SP library. 


Diagnosis: Understanding System Design 


VM/XA System Product: Diagnosis Guide, LY27-8056 


Provides diagnostic information. It describes how to locate problems within the VM/XA SP control 
program, and how to describe and report problems to IBM support personnel. The diagnosis reference 
publications describe how the system works. You should use them as supplements to this book. 


VM/XA System Product: CP Diagnosis Reference, LY 27-8054 


Describes each of the major VM/XA SP control program facilities. Also contains a module 
cross-reference list. 


VM/XA System Product: CMS Diagnosis Reference, LY27-8052 
Describes each of the major conversational monitor system facilities. 
VM/XA System Product: Group Control System Diagnosis Reference, LY27-8060 


Describes step-by-step procedures for identifying problems in each of the major facilities of the group 
control system and lists important GCS control blocks. 


VM/XA System Product: CP Data Areas and Control Blocks, LY27-8053 

Lists the data areas and control blocks used by the VM/XA SP control program. 

VM/XA System Product: CMS Data Areas and Control Blocks, LY27-8051 

Lists the data areas and control blocks used by CMS. 

VM/XA System Product: Dump Viewing Facility Operation Guide and Reference, SC23-0359 


Describes step-by-step procedures for using the dump viewing facility. The publication is also a reference 
for dump viewing facility commands and messages. 
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Reference: Retrieving Information Quickly 
¢ VM/XA System Product: CP Command Reference, SC23-0358 


Provides complete descriptions of the commands used to communicate with VM/XA SP, including usage 
notes. The commands are in alphabetical order. | | 


© VM/XA System Product: CMS Command Reference, SC23-0354 


Provides complete descriptions of the commands used to communicate with the CMS component of 
VM/XA SP. The commands are in alphabetical order. 


¢ VM/XA System Product: Group Control System Command and Macro Reference, SC23-0433 


Provides complete descriptions of the commands used to communicate with the GCS component of 
VM/XA SP and the macros that can be used in GCS application programs. This book also includes 
information about writing REXX EXECs for use under GCS. 


¢ VM/XA System Product: Features Summary, LY27-8058 


Provides a comprehensive survey of VM/XA SP at a higher level than the VM/XA SP CP Diagnosis 
Reference. Topics cover such areas as: | 


— Supported features, hardware, and operating systems 

— CP-owned direct access storage, CP virtual storage, and real storage organization 
— CP virtual and real machine management 

— CMS, GCS, and the dump viewing facility 

— VM/XA SP performance facilities and installation. 


¢ VM/XA System Product: System Messages and Codes Reference, SC23-0376 


Contains the system messages generated by the VM/XA SP CP, CMS, and GCS components. For each een 
message, the publication provides: | | 


— The message number 

— The message text 

— An explanation of why the message was issued 
— System action 

— Recommended operator action (if any) 

— Recommended user action (if any) 

— Return code (if any). 


The publication also documents all abend codes and wait state codes, as well as the reason for each code es 
and the recommended action. ( : 


¢ VM/XA System Product: CMS Application Program Development Reference, SC23-0402 


Describes the CMS programming interface. It includes descriptions of the CMS macros, DOS macros, 
and external-use control blocks. 


¢ VM/XA System Product: Quick Reference, SX23-0391 


Shows only the command syntax of all the VM/XA SP commands. The commands summarized in this 
publication are described in detail in the VM/XA System Product: CP Command Reference, the VM/XA 
System Product: CMS Command Reference, the VM/XA System Product: Dump Viewing Facility 
Operation Guide and Reference, and the VM/XA System Product: Group Control System Command and 
Macro Reference. 


¢ VM/XA System Product: System Product Editor Command and Macro Reference, SC23-0372 


Describes the system product editor commands, in alphabetical order. 
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VM/XA System Product: System Product Interpreter Reference, SC23-0374 
Describes the system product interpreter statements, in alphabetical order. 
VM/XA SP EXEC 2 Reference, SC23-0361 

Describes the EXEC 2 control words, in alphabetical order. 

VM/XA System Product: Library Guide, Glossary, and Master Index, GC23-0367 


Provides an overview of the library’s structure, a glossary, and a means for directly locating specific 
information within a manual or manuals. 


VM/XA System Product: CMS Primer Summary of Commands, SC23-0421 


Contains summary information about commands described in the VM/XA System Product: CMS Primer. 
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index 
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additional base CP minidisks 
installing 30 
AUTOLOG 191 30, 134 
CMSBATCH 195 30, 134 
DISKACNT 191 30, 134 
EREP 191 30, 134 
MAINT minidisks 30, 134 
OPERATNS 191 30, 134 
RSCS 191 134 
XAMAINT minidisks 232 
ADRP (Auto-Deactivation of Restricted 
Passwords) 608, 857 
allocating 
XAPO0O1 volume 27, 132, 229 
XAPO002 volume 28, 133, 230 
XASERV volume 26, 131, 228 
ALTAMS 
installing test saved segment 487 
ALTBAM 
installing test saved segment after service 484 
ALTDOS 
installing test saved segment after service 484 
alternate GCS nucleus placement 853 
ALTHELP segment 
installing after service 491 
ALTINST segment for System Product Editor and 
EXEC Languages 
installing after service 491 
ALTVSAM 
installing test saved segment 487 
APAR number 
finding corresponding PTF number 865 
apply exception log 
example 395 
apply list 
description 392 
example of 392, 393 
apply lists 
example of 392 
applying 
corrective service 
to dump viewing facility 537 
to GCS 547 
local service 570 
patch service 579 
program update service 
to dump viewing facility 537 
to GCS 547 
to licensed programs 563 
applying PTFs 392 
ASMGEND EXEC 
building system assembler 600 


ASMGEND EXEC (continued) 

format 600 

function 600 

messages 600 

usage notes 600 
Assembler H Version 2 

installing 43, 147, 245 
assembling 

DMSNGP profile 150 
assembly errors 

correcting 60, 164, 259 
attaching product tape 

to MAINT 23, 127 

to XAMAINT 224 
auxiliary control files 382 

creating 450, 454, 672 

definition 382 

examples of 382 

updating VM/XA System Product 382 


B 
backing up 
CMS 108, 212, 311 
CP 110, 313 
named saved systems 108, 212, 311 
BASE control record 
format 738 
function 738 
options 738 
bibliography 901 
build exception log 
example 396 
building 
CMS nucleus 48, 250, 679 
CP nucleus 679 
GCS nucleus 75, 179, 278, 347, 679 


C 


card reader 
defining with starter system 18, 122 
changes to this book 891 
CMS load map 41, 53, 145, 157, 243, 255 
CMS (conversational monitor system) 
ALTINST segment 491 
CMS load map 41, 53, 145, 157, 243, 255 
CMSINST segment 102, 206, 305, 335, 510 
generating 4, 48, 152, 250 
generating new module 601 
load list 
definition 397 
restriction 398 
load map 
description 398 
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CMS (conversational monitor system) (continued) 
loading national language files from feature 
tape 320 
modules 
regenerating 469, 589 
named saved systems 
backing up 108, 212, 311 
nucleus 
building 48, 250, 679 
building after loading national language files 
load address 39, 241 


326 


printing CMS load map 41, 53, 145, 157, 244, 256 


rebuilding after service 457 
regeneration requirements 589 
removing service 581 
system generation 48, 152, 250, 468, 499 
CMSAMS 
installing saved segment 
installing default 97, 201, 300 
reinstalling saved segment after service 
reinstalling default after service 507 
CMSBAM 
function 649 
installing saved segment 
installing default 93, 197, 296 
reinstalling saved segment after service 
reinstalling default after service 504 
SAMGEN EXEC 649 
CMSDOS 
installing saved segment 
installing default 93, 197, 296 
reinstalling saved segment after service 
reinstalling default after service 504 
CMSGEND EXEC 
command format 601 
function 601 
how it works 602 
messages 602 
options 601 
regenerating PROP command 602 
usage notes 601 
CMSINST segment for System Product Editor and 
EXEC Languages 102, 206, 305, 335 
reinstalling after service 510 
CMSVSAM 
installing saved segment 
installing default 97, 201, 300 
reinstalling saved segment after service 
reinstalling default after service 507 
commands 
DIRECTXA_ 607 
DISKMAP 610 
HCPLDR 613 
ITASK 634 
SETUP 652 
SPLOAD 653 
UPDATE 657 
UTILITY 668 
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commands (continued) 
VMFLKED 691 
VMFMERGE 695 
VMFNLS_ 698 
VMFPLC2_ 705 
VMFREMOV 719 
ZAP 734 
COMMENT control record 
format 741 
function 741 
configuration 
starter system requirements 747 
control blocks 
CP 849 
control files 
auxiliary 382 
CMS 381 
CMS macros 381 
example of 378 
forCP 381 
for dump viewing facility 381 
for GCS 381 
for local service 382 
for UTILITY EXEC 381 
for VM/XA SP loader 381 
generating CP 523 
HCPLDR 613 
how used 378 
used in VMFNLS EXEC procedure 698 
_ varying to generate multiple systems 380 
VMFHASM 684 
VMFMAC 688 
control records 
ZAP service program 734, 735 
BASE 738 
COMMENT 741 
DUMP 735 
END 741 
LOG 740 
NAME 737 
REP 739 
VER or VERIFY 738 
copy file 688 
COR descriptor file 387 
example of 387 
COR document 386 
correcting 
assembly errors 60, 164, 259 
load errors 68, 172, 272 
corrective service 
See also servicing the system 
applying to CMS 449, 450 
applying to CP 453, 454 
applying to dump viewing facility 437 
applying to GCS 547 
files used 385 
rebuilding CMS 457 
rebuilding CP 515 


( 
Oe 2 


corrective service (continued) 
- receiving for CMS 435 
6 receiving for CP 443 
# removing 581 
corrective service tape 
description 433 
mapping 439, 445 
CP (control program) 
applying corrective service 453 
applying program update service 453 
backing up 110, 313 
control blocks 849 
data areas 849 
generating 4 
generating nucleus 61, 165, 262 
hardware initial program load 66, 170, 270 
load list 
definition 397 
_ description 397 
( » restriction 398 
a. system generation 523 
load map 64, 168, 264, 526 
description 398 
saving 64, 264, 526 
loading national language files from feature 
tape 320 
modules 
regenerating 530, 595 
nucleus 
an building 679 
( E building after loading national language files 340 
_ generating 61, 165, 262 
saving IPLable copy on tape 668 
rebuilding after service 515 
receiving corrective service 443 
receiving program update service 443 
regeneration requirements 595 
removing service 581 
utilities 
regenerating 530 
coy CP-owned DASD 
( | reallocating 268 
creating auxiliary control files 450, 454, 672 
CTL option 
of UPDATE command 658 


D 


DASD (direct access storage device) 
CP-owned 
reallocating 268 
used by UTILITY EXEC 670 
data areas 
CP 849 
DCSSGEN command 
format 604 
functions 604 : 
messages 106, 210, 309, 338, 493 


DCSSGEN command (continued) 

using to install CMSINST segment 604 
DDRXA (DASD Dump/Restore Program) 3, 15, 118 
defining 

devices 17 

devices using starter system 17, 121 

minidisk passwords 69 
descriptor files 

example of 387 
Device Support Facilities 3 

loading 13, 116 
devices for system generation 

defining 17 
directory 

See user directory 
DIRECTXA (CMS command) 

command syntax 607 

examples 608 

function 607 

invocation by ITASK EXEC 25, 129, 227 

messages 609 

restrictions 608 

return codes 609 

storage requirements 608 

system generation 69, 173, 266 

usage notes 608 
disk maps 

3350 system residence device 781 

3375 system residence device 798 

3380 system residence device 815 

3380-E4 system residence device 829 

3380-K system residence device 844 
DISKMAP EXEC 

example 610 

format 610 

function 610 

usage notes 610 
display device | 

defining with starter system 20, 124 
DMKRIO ASSEMBLE file 

converting to HCPRIO ASSEMBLE 257 
DMKSYS ASSEMBLE file 

converting to HCPSYS ASSEMBLE 257 
DMSNGP ASSEMBLE file 

assembling 150 

loading 25, 227 

prompts 49, 153, 251, 327 

sample 748 

system generation 4 

tailoring 

existing system installation procedure 246 
Starter System installation procedure (first 


level) 44 
Starter System installation procedure (second 
level) 148 
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DOSGEN EXEC 
functions 611 
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DOSGEN EXEC (continued) 
installing ALTDOS 484 
installing CMSDOS 93, 197, 296 
messages 96, 200, 299, 486, 611 
reinstalling CMSDOS after service 504 

DUMP control record 
format 736 
function 735 
options 736 
usage notes 736 

dump utility 
putting on tape or DASD 267 

dump viewing facility 
corrective service 537 
modules 

regenerating 596 
program update service 537 
regeneration requirements 596 
removing service 581 


_ 


| 
END control record 
format 741 
function 741 
EREP (Environmental Recording Editing and Printing 
Program) 
installing 72, 176, 275 
error messages 867-890 
errors 
assembly 
correcting 60, 164, 259 
load 
correcting 68, 172, 272 
ESERV utility 
support using CMSBAM 649 
exception logs 
description of 393 
example of 395, 396 
exclude list 
description 393 
example of 393 
excluding PTFs 393 
EXEC procedures 
ASMGEND 600 
CMSGEND 601 
DISKMAP 610 
DOSGEN EXEC 611 
GROUP 612 
installing ALTDOS with DOSGEN 484 
installing ALTVSAM and ALTAMS with 
ALTVSAMG 487 
installing CMSBAM with SAMGEN 96, 200, 299 
installing CMSDOS with DOSGEN 93, 197, 296 
installing CMSVSAM and CMSAMS with 
VSAMGEN 97, 201, 300 
INSTFPP 623 
ITASK 129, 634 
loading from product tape 23, 127, 225 
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EXEC procedures (continued) 


reinstalling CMSBAM with SAMGEN after 


service 486, 506 


reinstalling CMSDOS with DOSGEN after 


service 504 


reinstalling CMSVSAM and CMSAMS with 


VSAMGEN after service 507 
SAMGEN 649 

SETUP 652 

SPLOAD 653 


loading from product tape 23, 127, 225 


UTILITY 668 
VMFAPPLY 672 
VMFBLD 679 
VMFHASM 684 
VMFLKED 691 
VMFMAC _ 688 
VMFMERGE 695 
VMFNLS_ 698 
VMFOVER_ 703 
VMFREC 709 
VMFREMOV 719 
VMFSETUP 722 
VMFVIEW 724 
VMFZAP_ 729 
VSEVSAM 731. 
ZAPTEXT 742 
EXECUPDT EXEC | 
using to regenerate CMS EXECs 474 
using to regenerate CP EXECs 533 
using to regenerate dump viewing facility 
EXECs 543 
existing system 
installing VM/XA SP using 219 
shutdown 270 
EXPAND command 
format 744 
function 743 
messages 745 
object deck form 743 
options 744 
EXPAND control record 
format 743 
usage notes 743 


- 
files 
used in corrective service 385 
used in program update service 385 
first-level installation 7 
formatting 
minidisks 30, 232 
XAPOO01 volume 27, 132, 229 
XAP002 volume 28, 133, 230 
XASERV volume 26, 131, 228 


( 
\ 
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G 
fr. GCS (group control system) 
. accessing other saved segments 10 
alternate nucleus placement 853 
authorized user [Ds_ 10 
building nucleus 75, 179, 278, 347 
common dump receiver 10 
configuration file 612 
authorized user IDs_ 10 
common dump receiver 10 
maximum virtual machines 10 
planning 9 
recovery machine 10 
saved segments 10 
system disk 10 
system disk extension 10 
system ID 10 
system name 10 
i trace table size 10 
( | corrective service 547 
description 9 


directory 

planning 9 
installing 

multiple GCS systems 9 
load list 


definition 397 
resctriction 398 


sie load map 
( ; description 398 
ase loading national language files from feature 
tape 320 


maximum virtual machines in group 10 
multiple systems 86, 190, 289, 349 
nucleus | 
alternate placement 853 
building 679 
building after loading national language files 347 
planning considerations 9 
en configuration file 9 
( storage requirements 9 
system directory entry 9 
system name table entry 9 
program update service 547 
recovery machine 10 
regeneration requirements 597 
removing service 581 
SAMPNSS EXEC entry 
planning 9 
saving 75, 179, 278, 347 
storage requirements 9 
system disk 10 
system disk extension 10 
system ID 10 
system name 10 
trace table 10 


generating 
CMS nucleus 48, 250 
group control system 
See GCS (group control system) 
GROUP EXEC 
creating GCS configuration file 612 
format 612 
function 612 


H 


HCPBOX ASSEMBLE file 
tailoring 55, 159, 257 
HCPLDR command 
command syntax 613 
control file 613 
function 613 
load list 613 
loader control statements 
conditional page boundary (CPB) 617 
delete (DEL) 622 
include control section (ICS) 621 
loader termination (LDT) 619 
padding (PAD) 618 
parameter (PRM) 618 
printer (PRT) 615 
replace (REP) 620 
set location counter (SLC) 617 
set page bound (SPB) 616 
subsystem (SYS) 619 
unconditional page boundary (UPB) 616 
verify (VER) 621 
system generation 523 
HCPRIO ASSEMBLE file 
converting DMKRIO 257 
creating from DMKRIO 257 
loading 25, 227 
sample 749 
system generation 4, 55, 159 
tailoring 55, 159 
HCPSYS ASSEMBLE file 
converting DMKSYS 257 
creating from DMKSYS_ 257 
loading 25, 227 
sample 
for 3350 767 
for 3375 784 
for 3380 801 
system generation 4, 55, 159 
tailoring 55, 159 
HELP facility 
loading national language files from feature 
tape 320 
HELP segment 102, 206, 305, 335 
reinstalling after service 510 
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I 
IBM Software Distribution 357 
image library 
installing default 73, 177, 276 
impact printer 
image library 
installing default 73, 177, 276 
INC option 
of UPDATE command 657 
installation heading 51, 155, 253, 329 
installation segment 50, 154, 252, 328 
installation tools 
DCSSGEN command 604 
ITASK EXEC 634 
SETUP EXEC 652 
SPLOAD EXEC 653 
UTILITY EXEC 668 
installing 
Assembler H Version 2 43, 147, 245 
EREP 72, 275 
first level 7 
licensed programs 623 
PTFs 392 
second level 7 
system generation 
tailoring DMSNGP profile 148 
system national language 317 
build new CMS nucleus 326 
build new CP nucleus 340 
build new GCS nucleus 347 
contents of national language feature tape 318 
create new GCS configuration file 345 
load language files from tape to disk 320 
INSTFPP EXEC 623 
after running 631 
before running 624 
format 623 
messages 632 
panels 627-631 
rerunning 633 
running in panel mode 627 
specifying products directly 631 
introduction 
local service 565 
patch service 577 
IOCP file 
sample 755 
IOCP (Input/Output Configuration Program) 5 
ISD 357 
ITASK EXEC 
CMS nucleus 48, 152, 250 
format 634 
function 634 
installing additional CP minidisks 30, 134, 232 
ITASK 
invoking 25, 227 
loading from product tape 23, 127, 225 
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ITASK EXEC (continued) 


L 


loading product tape 33, 137, 235 
messages 637 
options 635 
prompt 

for MAINT password 25, 227 

for OPERATOR password 25, 227 
prompt for MAINT password 129 
prompt for OPERATOR password 129 
system generation 4, 25, 44, 48, 129, 148, 152, 227, 

250 

tailoring DMSNGP profile 44, 246 

using the BASEIDS operand 30, 134, 232 


language 


specifying 49, 153, 251, 327 


licensed programs 


building after service 563 
installing 623 
program update service 563 


load errors 


correcting 68, 172, 272 


load list 


definition 397 
description 397 


load map 


CMS 41, 53, 145, 157, 243, 255 
CP 64, 168, 264, 526 

printing 41, 53, 65, 244, 256, 265 
saving 41, 53, 64, 243, 255, 264 


loading 


Device Support Facilities 13, 116 

directory 25, 227 

DMSNGP profile 25, 227 

HCPRIO ASSEMBLE 25, 227 

HCPSYS ASSEMBLE 25, 227 

national language files 320 

product tape 33, 70, 71, 137, 174, 175, 235, 273, 
274 

sample files 25, 129, 227 

starter system 17 

system generation tools 130 

tape files to disk 705 

update files 709 

user directory 25, 227 


local service 


See also servicing the system 
applying 570 

control files 382 
introduction 565 
preparation 566 

rebuilding CMS 457 
rebuilding CP 515 
removing 581 


local terminals 


using for installation 120 


ee 
oy 


LOG control record 
format 740 
functions 740 
usage notes 740 
logon passwords 
for MAINT and OPERATOR 6, 25, 130, 227 
security 6, 608, 857 


macro library 
VMFLKED 691 
VMFMAC 688 
MAINT virtual machine 
system generation 5 
use in service 360 
MAP file, PRELOAD utility program 647 
mapping 
COR tape 439, 445 
PUT tape 439, 445 
Memo to Users 388 
messages 867-890 
ASMGEND 600 
CMSGEND 602 
DCSSGEN command 106, 210, 309, 338, 493 
DIRECTXA command 609 
DOSGEN 611 
INSTFPP EXEC 632 
ITASK 637 
PRELOAD 648 
PROD LEVEL file 632 
repository 
updating for CMS 464 
updating for CP 521 
updating for GCS 555 
servicing CMS repository 464 
servicing CP repository 521 
servicing GCS repository 555 
SPLOAD 656 
UPDATE command 666, 686 
updating CMS repository 464 
updating CP repository 521 
updating GCS repository 555 
UTILITY 670 
VMFHASM EXEC 686 
VMFLKED 694 
VMFMAC EXEC 690 
VMFMERGE 697 
VMFNLS EXEC 702 
VMFREMOV EXEC 720 


VMFZAP_ 730 
VSEVSAM 732 
migrating 


spool files 269 

minidisk maps 
3350 system residence device 781 
3375 system residence device 798 
3380 system residence device 815 


minidisk maps (continued) 
3380-E4 system residence device 829 
3380-K system residence device 844 
minidisk passwords 
defining 69 
minidisks 
establishing access order 722 
formatting 30, 232 
minimum hardware configuration 747 
modules 
CMS 
regenerating 469, 589 
CP 
regenerating 530, 595 
dump viewing facility 
regenerating 596 
updating with VMFHASM 684 


N 


NAME control record 
format 737 
function 737 
options 737 
national language 
installing 317 
specifying 49, 153, 251, 327 
national language support 
updating message repository 
for CMS 464 
for CP 521 
for GCS 555 
NOINC option 
of UPDATE command 658 
NOSEQ8 option 
of UPDATE command 657 


| NOSTK option 


of UPDATE command 658 
NOSTOR option 
of UPDATE command 659 
nucleus 
building 679 
CP 
saving IPLable copy on tape 668 


O 


override file, product parameter 
description 419 
example 419 
overriding 
product parameter file 440, 446, 540, 550, 564 


Pp 

passwords | 
for MAINT and OPERATOR 6, 25, 130, 227 
restricted password list 608, 857 
security 6, 608, 857 
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patch facility 640 
patch update files 
description 389 
PID 357 
planning 
GCS 9 
national languages 11 
preferred virtual machine 
system generation 56, 160 
PRELOAD MODULE 
command format 646 
function 646 
input 646 
messages 648 
output 647 
reformatting TEXT files 646 
PRELOAD utility program 
MAP file 647 
TEXT file 647 
preparation 
local service 566 
preventive service 
See program update service 
primary system operator 
starter system 21, 125 
printer 
defining with starter system 17, 121 
printing | 
CMS load map 41, 53,.244, 256 
CP load map 65, 265 
PROD LEVEL file 
example 632 
update messages 632 
product contents directory 
description 387 
examples 387 
product parameter file 
copy 703 
description 401 
example 402 
minidisk access order 722 
overrides 
in override section of base file 402 
in separate override file 419 
overriding 440, 446, 540, 550, 564 
tags 
in component area 412 
in override area 418 
in product area 412 
tailoring 55, 159, 260 
temporary copy 
description 420 
examples 420 
product parameter override file 
description 419 
example 419 
product tape 
attaching to MAINT 23, 127 
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product tape (continued) 
attaching to XAMAINT 224 
format 3 


loading 33, 70, 71, 137, 174, 175, 235, 273, 274 


loading files from 127 
program update service 
See also servicing the system 
applying 579 
applying to CMS 449, 450 
applying to CP 453, 454 
applying to dump viewing facility 537 
applying to GCS 547 
applying to licensed programs 563 
files used 385 
introduction 577 
rebuilding CMS 457 
rebuilding CP 515 
receiving 578 
receiving for CMS 435 
receiving for CP 443 
receiving for licensed programs 563 
removing 581 
program update tape 
See PUT (program update tape) 
PTF number 
finding from APAR number 865 
PTF parts list 
description 392 
PTFs 
applying 392 
applying to SNA products 695 
applying using VMFMERGE 696 
excluding 393 
installing 392 
removing from SNA products 719 
removing using VMFREMOV 720 
publications 901 
punch 
defining with starter system 18, 122 
PUT descriptor file 
description 386 
example 386 
PUT document 386 
PUT (program update tape) 357 
description 429 
format 430 
mapping 439, 445 


R 


reader 
defining with starter system 18 
rebuilding | 
CMS nucleus 679 
CP nucleus 679 
GCS nucleus 679 
receive exception log 
description 394 


\ 
Ne =e ie 


2, 


receive history log 
description 397 
receiving 
local service 568 
patch service 578 
program update service 
for licensed programs 563 
service files 440, 446, 709 
regenerating 
CMS 589 
CP 595 
dump viewing facility 596 
GCS 597 
removing 
PTFs 581 
service 581 
REP control record 
example 740 
function 739 


special consideration during ZAP processing 741 


usage notes 739 
restart indicator files 

description 398 
restarting 

installation 126 

VMFREC EXEC 398 
restoring 

starter system to disk 15, 118, 221 
restricted password list 608, 857 
RPWLIST DATA 608, 857 


S 


SAM (Sequential Access Method) 
support using CMSBAM 649 
SAMGEN EXEC 
functions 649 
installing CMSBAM = 96, 200, 299 


reinstalling CMSBAM after service 486, 506 


using to install CMSBAM segment 649 
sample files 
DMSNGP ASSEMBLE 748 
HCPRIO ASSEMBLE sample file 749 
HCPSYS ASSEMBLE 
for 3350 767 
for 3375 784 
for 3380 801 
IOCP sample file 755 
loading 25, 129, 227 
messages 651 
product parameter sample file 402 
usage notes 650 
user directory 
for 3350 769 
for 3375 786 
for 3380 803 
for 3380-E4 817 
for 3380-K 832 


SAMPNSS EXEC 
format 650 
saved segments 
installing ALTDOS and ALTBAM 484 
installing ALTVSAM and ALTAMS 487 
installing CMSDOS and CMSBAM 93, 197, 296 
installing CMSVSAM and CMSSAMS _§ 97, 201, 300 
reinstalling CMSDOS and CMSBAM after 
service 504 
reinstalling CMSVSAM and CMSSAMS after 
service 507 
saving 
CMS load map 41, 53, 243, 255 
CP load map 64, 264 
GCS nucleus 75, 179, 278, 347 
second-level installation 7 
security 
password 6, 608, 857 
self-documenting text decks 
description 390 
SEQ8 option 
of UPDATE command 657 
service files 
description 389 
example of 389, 390, 391, 393, 395, 396, 397 
guidelines 384 
loading 709 
naming conventions 383 
receiving 440, 446, 709 
temporary load list 398 
service level update 432 
service tape 
mapping 439, 445 
servicing the system 613, 657, 684, 688, 691, 724 
applying updates to national language-related files 
using VMFNLS_ 699 
control file 
for CMS 381 
for CMS macros 381 
for CP 381 
for dump viewing facility 381 
for GCS 381 
for HCPLDRCM 381 
for loader 381 
for UTILITY EXEC 381 
control file identifiers 380 
COR descriptor file 387 
COR document 386 
corrective service 385 
applying to CMS 449 
applying to CP 453 
receiving for CMS 435 
receiving for CP 443 
removing 581 
emergency service using patch facility 
applying 579 
introduction 577 
receiving 578 
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servicing the system (continued) 
local service 
applying 570 
introduction 565 
preparation 566 
receiving 568 
removing 581 
MAINT virtual machine 360 
Memo to Users 388 
product contents directory 387 
program update service 385 
applying to CMS 449 
applying to CP 453 
receiving for CMS 435 
receiving for CP 443 
removing 581 
PUT descriptor file 386 
PUT document 386 
service level update 432 
service overview 355 
source-maintained products 
files used 377 
tools and EXECS used during the service 
process 366 
UPDATE command 657 
setting 
TOD clock 21 
SETUP EXEC 
format 652 
SNA (System Network Architecture) 
applying PTFs 695, 719 
applying ZAPs 729 
source update files 
description 389 
specifying 
national language 49, 153, 251, 327 
SPLOAD EXEC 
format 653 
function 653 
loading from product tape 23, 127, 225 
messages 656 
system generation 4 
SPLOAD PROFILE 
copy of 653 
loading from product tape 23, 127, 225 
syntax 653 
used by SPLOAD EXEC 653 
spool files 
migrating from VM/SP to VM/XA SP 
SPTAPE command 
using to migrate spool files 269 
stand-alone dump utility 
putting on tape or DASD 267 
Starter system 
HCPRIO ASSEMBLE sample file 749 
~HCPSYS ASSEMBLE 
for 3350 767 
for 3375 784 
for 3380 801 
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starter system (continued) 


IOCP sample file 755 

loading 17, 121 

minimum hardware configuration 747. 
restoring to disk 15, 118, 221 
shutdown 66, 170 


system residence DASD allocation for 3350 780 
system residence DASD allocation for 3375 797 
system residence DASD allocation for 3380 814 
system residence DASD allocation for 3380-E4 828 
system residence DASD allocation for 3380-K 843 


user directory 
for 3350 769 
for 3375 786 
for 3380 803 
for 3380-E4 817 
for 3380-K 832 
using to define devices 17, 121 


Starter system tape 


format 3 


starter system worksheet 6 
STK. option 


of UPDATE command 658 


stopping and restarting installation 126 
STOR option 


of UPDATE command 658 


summary of changes to this book 891 
SYSCPVOL, HCPSYS macro instruction 


system generation 57, 161 


SYSID, HCPSYS macro instruction 


system generation 457, 161 


SYSRES, HCPSYS macro instruction 


system generation 56, 160 


SYSSTORE, HCPSYS macro instruction 


system generation 56, 160 


system assembler, building 600 
system generation 


Assembler H Version 2 43, 147, 245 
backing up 

CMS 108, 212, 311 

CP 110, 214, 313 

named saved systems 108, 212, 311 
building 

CMS nucleus 48, 152, 250 

CP nucleus 61, 165, 262 
CMS load map 41, 53, 145, 157, 243, 255 
CP load map 64, 168, 264, 526 
creating 


creating the CMSINST segment 102, 206, 305, 335 
creating the HELP segment 102, 206, 305, 335 


defining 

devices 17, 121 
formatting DASD volumes 115 
HCPSYS, HCPRIO 55, 159 
image library 276 
installing 

image library 73, 177 


installing CMSDOS and CMSBAM 93, 197, 296 


system generation (continued) 
installing CMSVSAM AND CMSSAMS $97, 201, 
300 


ITASK EXEC 25, 48, 61, 129, 152, 165, 227, 250, 


262 
loading | 
CP nucleus 66, 170, 270 
Device Support Facilities 13 
loading starter system 17 
product tape 33, 137, 235 
starter system 17, 121 
loading starter system 3 
MAINT 5 
preparing for 11 
product tape 25, 127, 129, 227 
restoring starter system to disk 15, 118, 221 
spooling console during 22, 126 
tailoring DMSNGP profile 44, 148, 246 
user directory 69, 173, 266 
VMFBLD EXEC 523 
system generation tools 
loading 130 
system identification 
system generation 57, 161 
system national language 
installing 317 
System Network Architecture 
See SNA (System Network Architecture) 


system nucleus 4, 48, 61, 66, 152, 165, 170, 250, 262, 


270 
system residence disk 
system generation 56, 160 
SYSTIME, HCPSYS macro instruction 
system generation 57, 161 
SYSUVOL, HCPSYS macro instruction 
system generation 57, 161 


T 


tailoring 
DMSNGP profile 
existing system installation procedure 246 
Starter System installation procedure (first 
level) 44 
Starter System installation procedure (second 
level) 148 
HCPBOX ASSEMBLE 
Starter System installation procedure (first 
level) 55, 159 
HCPRIO ASSEMBLE 
Starter System installation procedure (first 
level) 55, 159 
HCPSYS ASSEMBLE 
Starter System installation procedure (first 
level) 55, 159 
product parameter file 
existing system installation procedure 260 
Starter System installation procedure (first 
level) 55, 159 


tailoring (continued) 

user directory 

Starter System installation procedure (first 
level) 69 
Starter System installation procedure (second 
level) 173 

tape control, VMFPLC2 23, 127, 225, 705 
tape devices 

defining with starter system 18, 122 
temporary load list 

description 398 

example of 398 
temporary product parameter file 

description 420 

examples 420 
terminal 

defining with starter system 20, 124 
Text Decks 

example of 390 
text decks, self-documenting 

description 390 
TEXT files reformatted by PRELOAD utility 646 
TEXT file, PRELOAD utility program 647 
text shells 

description 391 

example of 391 
TOD (time-of-day) clock 21, 125 

setting 21 


U 
UPDATE command 
description 657 
files used by 662 
messages 666 
multilevel update 663 
with auxiliary control file 664 
options 657 
CTL 658 
DISK 658 
INC 657 
NOCTL 658 
NOINC 658 
NOREP 657 
NOSEQ8_ 657 
NOSTK 658 
NOSTOR_ 659 
NOTERM 658 
PRINT 658 
REP 657 
SEQ8 657 
STK 658 
STOR 658 
TERM 658 
preferred aux files 665 
single-level updates 662 
update control statements 659 
DELETE 661 
format 659 
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UPDATE command (continued) 
update control statements (continued) 
INSERT 660 | 
REPLACE 661 
SEQUENCE 659 
* (comment) 662 
UPDLOG file type, use with 658 
use of control files 378 
update control statements 659 
update files 
description 389 
example of 389, 390 
guidelines 384 
loading 709 
naming conventions 383 
receiving 440, 446, 709 
update shells 
description 390 
updating 
HCPLDR 613 
macro libraries 688 
servicing the system 613, 657, 684, 688, 691, 724 
source files 657 
tailoring DMSNGP profile 44, 148, 246 
VMFHASM EXEC 657, 684 
VMFLKED 691 
VMFMAC 688 
VMFVIEW EXEC 724 
USER DIRECT 
See user directory 
user directory 
creating 26, 228 
DIRECTXA_ 607 
loading 25, 227 
sample 
for 3350 769 
for 3375 786 
for 3380 803 
for 3380-E4 817 
for 3380-K 832 
sample XAMAINT entry 
for 3350 778 
for 3375 795 
for 3380 812 
for 3380-E4 826 
for 3380-K 841 
system generation 4, 69, 173, 266 
updating 69, 266 
using DISKMAP EXEC to check changes 610 
user-owned DASD volumes 
system generation 57, 161 
utilities 
CP 
regenerating 530 
UTILITY EXEC 
format 668 
functions 668 
messages 670 
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_ UTILITY EXEC (continued) 


options 669 


V 


VER control record 

example 739 

format 738 

function 738 

options 738 

special consideration during ZAP processing 741 
version identification 51, 155, 253, 329 
VMFAPPLY EXEC 672 

creating auxiliary control files 672 

exception log 395 

function 672 

return codes 678 
VMFBLD EXEC 679 

building the nucleus 679 

exception log 396 

function 679 

return codes 683 

system generation 468, 499 
VMFHASM EXEC 

command syntax 684 

control file 684 

function 685 

input and output files 686 

messages 686 

servicing the system 684 

UPDATE command 684 

using to update modules 684 
VMFLKED EXEC 

command procedure 691 

command syntax 691 

error messages 694 

format 691 

function 691 

how it works 691 

input files 692 

output files 693 

using to link-edit modules 691 

when to use 691 
VMFMAC EXEC 

command syntax 688 

control file 688 

function 688 

input and output files 689 

macro library 688 

messages 690 
VMFMERGE EXEC 

command options 695 

command procedure 695 

error messages 697 

format 695 

how it works 696 

usage notes 696 

using to apply PTFs 695 


VMFMERGE EXEC (continued) 
when to use 695 
VMENLS EXEC 
command procedure 698 
command syntax 698 
format 698 
messages 702 
operands 698 
options 698 
when to use 698 
VMFOVER EXEC 703 
copying product parameter file 703 
function 703 
VMFPLC2 command 
command syntax 705 
loading tape files to disk 705 
system generation 23, 127, 225 
VMFREC EXEC 709 
exception log 394 
function 709 
receiving update files 709 
restarting 398 
return codes 716 
VMFREC History File 
example of 397 
VMFREMOV EXEC 
command options 719 
command procedure 719 
format 719 
how it works 720 
messages 720 
using to remove PTFs 719 
when to use 719 
VMFSETUP EXEC 722 
function 722 
VMFVIEW EXEC 
command syntax 724 
servicing the system 724 
using to view exception logs 724 
VMFZAP EXEC 
format 729 
how it works 729 
messages 730 
using to apply ZAPs 729 
when to use 729 
VM/SP (Virtual Machine/System Product) 
installing VM/XA SP using 219 
VSAMGEN EXEC 
messages 99, 203, 302, 488, 507 
VSEVSAM EXEC 
command procedure 731 
command syntax 731 
format 731 
messages 732 
use, example 731 
when to use 731 


VSE/VSAM (Virtual Storage Extended/Virtual Storage 


Access Method) 


VSE/VSAM (Virtual Storage Extended/Virtual Storage 


Access Method) (continued) 
support using CMSBAM 649 


W 


work pack 
defining with starter system 19 
worksheet, starter system 6 


X 
XAMAINT virtual machine 
defining directory entry 220 
sample directory entry 
for 3350 778 
for 3375 795 
for 3380 812 
for 3380-E4 826 
for 3380-K 841 
XAPO0O1 volume 
allocating 27, 132, 229 
formatting 27, 132, 229 
XAP002 volume 
allocating 28, 133, 230 
formatting 28, 133, 230 
XASERV volume 
allocating 26, 131, 228 
formatting 26, 131, 228 
XEDIT (System Product Editor) 
providing support on local terminals 120 


Zz 
ZAP command 
command procedure 734 
description 734 
format 734 
input control records 734, 735 
BASE 738 
COMMENT 741 
DUMP 735 
END 741 
function 735 
LOG 740 
NAME 737 
REP 739 
VER or VERIFY 738 
option output 735 
options 734 
when to use 734 
ZAPTEXT EXEC 
format 742 
input control records 742 
options 742 
procedure 742 
use of EXPAND command 743 
when to use 742 
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Numerics 
1403 printer 
image library 
installing default 73, 177, 276 
3203 printer 
image library | 
installing default 73, 177, 276 
3211 printer 
image library 
installing default 73, 177, 276 
3262 printer 
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Please use this form to communicate your comments about the usability of the VM system, with the under- 
standing that IBM may use or distribute whatever information you supply in any way it believes appropriate 
without incurring any obligation to you. 


Your comments will be sent to the Product Usability Department for appropriate review and action, if any. 
Comments may be written in your own language; English is not required. 
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c = Diagnosis CJ End Use & 
© 0 Other ie 
Oo 
c? 
a. i) 
+ 
Oo ® 
° 8 
= @ 
os 
4] 
28 
33 
No 


Note: 


We appreciate your comments. 


If you would like a reply, please supply your name and address on the reverse side of this form. No 
postage stamp necessary if mailed in the U.S.A. (Elsewhere, an IBM office or representative will be happy 
to forward your comments or you may mail directly to the address in the Edition Notice on the back of the 
title page.) 
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operators of IBM systems. You may use this form to communicate your comments about this publication, 
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